chatmcp/README_TR.md

chatmcp

Platformlar Arası MacOS | Windows | Linux | iOS | Android | Web Yapay Zeka Sohbet İstemcisi

English | 简体中文 | Türkçe

Kurulum

macOS	Windows	Linux	iOS	Android	Web
İndir	İndir	İndir ¹	TestFlight	İndir	GitHub Pages ²

¹ Not: Linux gereksinimleri aşağıdadır (Ubuntu 22.04 ve 24.04)

² Not: Web sürümü tamamen tarayıcınızda çalışır ve sohbet geçmişi ile ayarlar için yerel depolama kullanır.

Dokümantasyon

Ayrıca, chatmcp hakkında daha fazla bilgi edinmek için DeepWiki'yi kullanabilirsiniz. DeepWiki, herhangi bir herkese açık GitHub deposunu tam etkileşimli, kolay anlaşılır bir wiki'ye dönüştüren yapay zeka destekli bir platformdur. Kodları, dokümantasyonu ve yapılandırma dosyalarını analiz ederek net açıklamalar ve etkileşimli diyagramlar oluşturur, hatta yapay zeka ile gerçek zamanlı olarak soru-cevap yapmanıza olanak tanır.

Kullanım

Sisteminizde uvx veya npx'in kurulu olduğundan emin olun.

MacOS

• uvx için

brew install uv

• npx için

brew install node

Linux

• uvx için

curl -LsSf https://astral.sh/uv/install.sh | sh

• npx için (apt kullanarak)

sudo apt update
sudo apt install nodejs npm

Linux Gereksinimleri (Ubuntu 22.04 ve 24.04)

ChatMCP AppImage/DEB çalıştırmak için aşağıdaki paketlerin kurulu olması gerekir:

• AppImage (FUSE): libfuse2
• GTK 3: libgtk-3-0
• Grafik/EGL:
  • Ubuntu 22.04: libegl1-mesa, libgles2, libgl1-mesa-dri, libglx-mesa0
  • Ubuntu 24.04: libegl1, libgles2, libgl1-mesa-dri, libglx-mesa0
• X11 yardımcıları ve SQLite: libx11-6, xdg-utils, libsqlite3-0

Kurulum komutları:

• Ubuntu 22.04:

sudo apt install -y libfuse2 libgtk-3-0 libegl1-mesa libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0

• Ubuntu 24.04:

sudo apt install -y libfuse2 libgtk-3-0 libegl1 libgles2 libgl1-mesa-dri libglx-mesa0 libx11-6 xdg-utils libsqlite3-0

Opsiyonel (önerilir): mesa-vulkan-drivers, mesa-utils (glxinfo gibi teşhis araçları)

1. Ayarlar sayfasında LLM API Anahtarınızı ve Uç Noktanızı (Endpoint) yapılandırın.
2. MCP Sunucusu sayfasından bir MCP sunucusu kurun.
3. MCP Sunucusu ile sohbete başlayın.

• stdio mcp sunucusu
• sse mcp sunucusu
• Hata Ayıklama Modu (Debug)

• Kayıtlar (Loglar) & Veriler

macOS:

~/Library/Application Support/ChatMcp

Windows:

%APPDATA%\ChatMcp

Linux:

~/.local/share/ChatMcp

Mobil:

• Uygulama Belgeler Dizini Uygulamayı sıfırlamak için bu komutları kullanabilirsiniz:

macOS:

rm -rf ~/Library/Application\ Support/ChatMcp

Windows:

rd /s /q "%APPDATA%\ChatMcp"

Linux:

rm -rf ~/.local/share/ChatMcp
rm -rf ~/.local/share/run.daodao.chatmcp

Geliştirici Notları

Flutter paketlerini yükleyin

flutter pub get

Çalıştırmak için:

• linux:

flutter run -d linux

• macOS:

flutter run -d macos

Zorunlu Kod Formatı ve Pre-commit Hook

Katkı verenler arasında tutarlı bir kod stili sağlamak için, bu depoda her commit öncesi Dart formatlaması zorunludur.

• Sürüm kontrolünde bulunan bir Git hook dosyası .githooks/pre-commit ile gelir.
• Commit sırasında dart format . çalıştırılır, değişen dosyalar yeniden git add edilir ve ardından hiçbir dosyanın format dışı kalmadığını doğrulayan bir kontrol yapılır.
• Yerelde format dışı commit’ler reddedilir; ayrıca CI üzerinde de format dışı PR’lar kırılır.

Hızlı kurulum (her klon sonrası bir defa):

make setup-git-hooks

El ile kurulum (alternatif):

git config core.hooksPath .githooks
chmod +x .githooks/pre-commit

Gereksinimler (PATH üzerinde en az biri olmalı):

• Dart SDK, veya
• Flutter (Dart içerir)

Örnekler:

• macOS/Linux (Flutter):

  export PATH="$PATH:$HOME/flutter/bin"
  which flutter && flutter --version
  which dart && dart --version
  

• macOS/Linux (Dart SDK):

  export PATH="$PATH:$HOME/dart-sdk/bin"
  which dart && dart --version
  

• Windows (PowerShell): Kullanıcı/Sistem PATH’ine C:\\src\\flutter\\bin (veya Flutter kurulu yolunuz) ekleyin. Doğrulama:

  where flutter
  where dart
  

IDE notu: PATH’i değiştirdikten sonra IDE’nizi yeniden başlatın; commit işlemleri güncel ortam değişkenlerini miras almalıdır.

CI doğrulaması:

• GitHub Actions check-format workflow’u push/PR’larda dart format --output=none --set-exit-if-changed . çalıştırır ve format dışı dosyalar varsa job kırılır.

Politika:

• Hook’ları atlamayın (örn. --no-verify). Bu durumda da CI kırılacak ve yine formatlamanız gerekecektir.

• Windows:

flutter run -d windows

• Android(emulator or gerçek cihaz):

flutter run -d "Pixel ..."

Web Sürümü Geliştirme ve Dağıtım

Yerel Geliştirme

# Bağımlılıkları yükle
flutter pub get

# Web sürümünü yerel olarak çalıştır
flutter run -d chrome
# veya port belirterek
flutter run -d chrome --web-port 8080

Web Sürümünü Oluşturma

# Üretim sürümünü oluştur
flutter build web

# Alt dizin için temel yol belirterek oluştur
flutter build web --base-href /chatmcp/

GitHub Pages'e Dağıtım

# 1. Web sürümünü oluştur
flutter build web --base-href /chatmcp/

# 2. build/web dizininin içeriğini gh-pages dalına gönder
# veya GitHub Actions ile otomatik dağıtım kullan

Oluşturma tamamlandıktan sonra, dosyalar build/web dizininde olacak ve herhangi bir statik web site barındırma hizmetine dağıtılabilir.

Uygulamanın Temel Özellikleri

• MCP Sunucusu ile Sohbet
• MCP Server Market
• MCP Sunucusunu Otomatik Kurulum
• SSE MCP Aktarım Desteği
• Otomatik MCP Sunucusu Seçimi
• Sohbet Geçmişi
• OpenAI LLM Modeli
• Claude LLM Modeli
• OLLama LLM Modeli
• DeepSeek LLM Modeli
• RAG (Retrieval-Augmented Generation)
• Daha İyi Arayüz Tasarımı
• Koyu/Açık Tema

Her türlü özellik önerisine açığız. Fikirlerinizi veya bulduğunuz hataları Issues sayfasından bize iletebilirsiniz.

MCP Server Market

MCP Server Market'ten dilediğiniz MCP sunucusunu kurabilirsiniz. MCP Server Market, farklı veri türleriyle sohbet etmek için kullanabileceğiniz MCP sunucularının bir koleksiyonudur.

• Ayrıca yeni MCP Server ekleyebilirsiniz : MCP Server Market

mcp_server_market deposunu forklayın ve mcp_server_market.json dosyasının sonuna yeni MCP Server ekleyin.

{
    "mcpServers": {
        "existing-mcp-servers": {},
        "your-mcp-server": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/username/your-mcp-server",
                "your-mcp-server"
            ]
        }
    }
}

Değişikliklerinizi bir Pull Request göndererek paylaşabilirsiniz. PR onaylandıktan sonra MCP Server Market'te görünecektir ve diğer kullanıcılar da aynı anda kullanmaya başlayacaktır.

Geri bildirimleriniz, chatmcp'yi geliştirmemize ve diğer kullanıcıların bilinçli kararlar almasına yardımcı olur.

• Teşekkürler
• MCP
• mcp-cli

Lisans

Bu proje Apache License 2.0 ile lisanslanmıştır.

GitHub Yıldız Geçmişi