convez.ai
MCP ServerFinanceiroAvançado
ayzekhdawy

Türkiye MCP

ayzekhdawy/turkiye-mcp

Assistente legal e financeiro turco via MCP com acesso a 31 ferramentas de dados oficiais

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra dados legais, financeiros, de licitações e de mercado turcos em um assistente de IA. Acessa naturalmente bases como Corte de Cassação, Conselho de Estado, Constituição, registro de licitações EKAP, B3 e mais, com suporte a upload de documentos e análise de jurisprudência.

Instalação

$npx convez-ai ayzekhdawy/turkiye-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
9
Forks
4
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v1.7.4
Issues abertas
0
Contribuidores
1

Casos de uso

  • Pesquisa jurisprudencial automatizada em tribunais turcos
  • Análise de licitações públicas e dados de mercado financeiro
  • Extração de decisões precedentes a partir de documentos UYAP
  • Consultas em linguagem natural sobre legislação e impostos turcos

Veredito

Ferramenta especializada e bem integrada para ecossistema turco, com 31 MCP tools conectadas a bases oficiais. Requer Python 3.11+ e é voltada a profissionais de direito e finanças; uso limitado fora do contexto turco.

README

A tradução para o português deste README ainda está na fila.

🇹🇷 Türkiye MCP

Türk hukuk, mali, ihale ve piyasa verileri için yapay zekâ asistanı + MCP sunucusu

Tek bir masaüstü uygulamasında: Yargıtay, Danıştay, Anayasa Mahkemesi, KİK, Resmi Gazete, GİB, SGK, EKAP ihaleleri, BIST ve daha fazlasına doğal dille erişin. Belge yükleyin, emsal kararları çektirin, sohbetlerinizi klasörlerde saklayın.

Release Download Platform Python License

⬇️ Windows için indir (TurkiyeMCP.exe)

# 1. Repoyu klonla
git clone https://github.com/ayzekhdawy/turkiye-mcp.git
cd turkiye-mcp

# 2. Kurulum betiğini çalıştır (Python 3.11+ gerekli)
chmod +x install-macos.command
./install-macos.command

# 3. Başlat
./TurkiyeMCP.command

Veya çift tıklayarak: install-macos.command → kurulum, TurkiyeMCP.command → başlatma.

Port değiştirmek için: TURKIYE_MCP_PORT=9090 ./TurkiyeMCP.command


🖼️ Ekran Görüntüleri


✨ Öne Çıkanlar

  • 🤖 Doğal dil sohbeti — "2025 asgari ücret ne kadar?", "Yargıtay mülkiyet hakkı kararları", "Ankara'daki aktif ihaleler" gibi sorulara, ilgili devlet veritabanlarını otomatik tarayarak kaynaklı ve markdown formatında yanıt verir.
  • 📄 Belge yükle → sor → emsal çektir — PDF, UYAP (EYP/UDF) veya metin belgesi yükleyin; esas/karar numaraları otomatik çıkarılır, belge bağlam olarak modele iletilir ve ⚖ Emsal ile ilgili içtihatlar getirilir.
  • 🗂️ Çalışma alanı — Sohbetlerinizi klasörlere ayırın, sürükle-bırakla taşıyın. Oturumlar sunucuda saklanır; uygulamayı kapatıp açsanız bile kaldığınız yerden devam edersiniz.
  • 🔌 Kendi modelin (BYOK) — OpenRouter, OpenAI, Anthropic, Google Gemini, Ollama (Yerel) ve Ollama Cloud desteği. Yerel Ollama seçilince makinenizdeki modeller (cloud-proxy dahil: gpt-oss:120b-cloud vb.) otomatik listelenir. API anahtarınız yalnızca cihazınızda saklanır.
  • 🧩 MCP sunucusu — Aynı araçlar Claude Desktop, Claude Code, Cursor ve VS Code'a MCP (Model Context Protocol) üzerinden bağlanır.
  • 🖥️ Tek dosya, kurulumsuz — TurkiyeMCP.exe'yi çift tıklayın; ek kurulum gerekmez. Veriler cihazınızda kalır.

📚 Kapsanan Veri Kaynakları

AlanKaynaklarAraç
⚖️ Hukuk / YargıYargıtay · Danıştay · Anayasa Mahkemesi · KİK · Rekabet Kurumu · Sayıştay · BDDK · KVKK · Sigorta Tahkim · Uyuşmazlık · EMSAL · Bedesten~13
📋 MevzuatMevzuat Bilgi Sistemi (kanun, KHK, yönetmelik, tebliğ)~2
💰 Mali / SMMMResmi Gazete · GİB sirküler · İVD (e-Fatura) · SGK · İŞKUR · TÜRMOB · İSMMMO · asgari ücret · vergi takvimi~10
🏗️ İhaleKamu ihaleleri (EKAP v2) · resmi ilanlar (ilan.gov.tr)~3
📈 PiyasaBIST hisseleri · döviz kurları · kripto~3

Toplam ~31+ araç — tümü tek arayüzde.


🚀 Hızlı Başlangıç

Seçenek 1 — Hazır Uygulama (önerilen)

  1. En son sürümü indirin → TurkiyeMCP.exe
  2. Çift tıklayarak çalıştırın (ilk açılışta modüller ~20-30 sn yüklenir).
  3. Sağ üstten ⚙ Ayarlar → sağlayıcı ve model seçin → ⚡ Bağlantıyı Test Et.
  4. Soru sorun, belge yükleyin, klasör oluşturun.

💡 Ücretsiz/yerel kullanım: Ollama kuruluysa, Ayarlar'da Ollama (Yerel) seçtiğinizde modelleriniz otomatik listelenir ve API anahtarı gerekmez.

Seçenek 2 — Kaynaktan Çalıştırma

git clone https://github.com/ayzekhdawy/turkiye-mcp.git
cd turkiye-mcp
pip install -r requirements.txt

# Masaüstü uygulaması (pencere + tray)
python local_run.py

# veya sadece web sunucusu
python -m uvicorn app:starlette_app --host 127.0.0.1 --port 8080
# → http://localhost:8080

🖱️ Arayüz Rehberi

Bölümİşlev
+ Yeni Sohbet / 🗂 Yeni KlasörSohbet başlatın, klasör oluşturun; sohbetleri sürükle-bırakla klasöre taşıyın
Çalışma AlanıKlasör ağacı; oturumlar sunucuda kalıcı, en son oturum otomatik açılır
📎 Belge ekleComposer'daki ataç ile PDF/UYAP/TXT yükleyin → ek "chip" olarak iliştirilir, referanslar çıkarılır
⚖ EmsalEkli belge için emsal kararları ve içtihatları tek tıkla aratır
Model chip / ⚙ AyarlarSağlayıcı + model + API anahtarı; sağlayıcı başına ayrı anahtar hatırlanır; "Bağlantıyı Test Et"
ModüllerAktif/pasif modül sayısı (Hukuk, Mali, İhale, Borsa) gerçek zamanlı
📋 / 📄Her yanıtı panoya kopyalayın veya Word (.doc) olarak indirin

🔌 Desteklenen LLM Sağlayıcıları

SağlayıcıAPI AnahtarıNot
Ollama (Yerel)❌localhost:11434; modeller otomatik listelenir (cloud-proxy dahil)
Ollama Cloud✅ollama.com anahtarı; gpt-oss, deepseek-v3.1, qwen3-coder vb.
OpenRouter✅Tek anahtarla çok sayıda model
OpenAI✅gpt-4o, gpt-4o-mini …
Anthropic✅claude-*
Google Gemini✅gemini-2.0-flash …

🔒 Anahtarlar yalnızca cihazınızda (localStorage + yerel keyring) saklanır, hiçbir sunucuya gönderilmez.


🧩 MCP Sunucusu Olarak Kullanım

Türkiye MCP, aynı araçları Model Context Protocol üzerinden IDE/asistanlara açar. Sunucu çalışırken (http://localhost:8080) aşağıdaki istemcilere ekleyebilirsiniz.

%APPDATA%\Claude\claude_desktop_config.json (Windows) / ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "turkiye": { "url": "http://localhost:8080/sse" }
  }
}
claude mcp add turkiye --transport sse http://localhost:8080/sse
claude mcp list
{ "mcpServers": { "turkiye": { "url": "http://localhost:8080/sse" } } }
{ "servers": { "turkiye": { "type": "sse", "url": "http://localhost:8080/sse" } } }

🔌 SSE Bağlantısı (Geliştiriciler için)

Türkiye MCP, SSE (Server-Sent Events) transport'u ile çalışır. Bu sayede hem yerel hem de uzak (ör. Railway, Docker) dağıtımlarda HTTP üzerinden bağlanılabilir.

EndpointYöntemAçıklama
/sseGETSSE akışını açar; sunucu bir session_id ve mesaj endpoint'i döner
/messages/?session_id=…POSTJSON-RPC 2.0 mesajları (MCP protokolü) gönderilir
/healthGETJSON sağlık kontrolü (aktif modüller, skill sayısı)
/GETWeb dashboard (arayüz)

Bağlantı akışı:

1) GET /sse                         → text/event-stream açılır
2) Sunucu "endpoint" event'i yollar → /messages/?session_id=<id>
3) POST /messages/?session_id=<id>  → {"jsonrpc":"2.0","method":"tools/list",...}
4) Yanıtlar /sse akışından event olarak gelir

Hızlı test (curl):

# SSE akışını dinle (session_id'yi buradan al)
curl -N http://localhost:8080/sse

# Başka bir terminalde araç listesini iste
curl -X POST "http://localhost:8080/messages/?session_id=SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Uzak dağıtım: Railway/Docker üzerinde PORT otomatik atanır. Bağlantı URL'sini https://<alan-adınız>/sse olarak verin. Herhangi bir MCP uyumlu istemci (Claude Desktop/Code, Cursor, VS Code, kendi SDK'nız) bu endpoint'e bağlanabilir.


🧠 "Avukat gibi" yetenekler

Türkiye MCP yalnızca arama yapmaz; bağlama göre uzmanlaşır:

  • Belge zekâsı — Yüklenen belgenin türünü (dava dilekçesi, mahkeme kararı, sözleşme, ihtarname, fatura…), taraflarını ve konusunu otomatik tespit eder.
  • İlgililik denetimi — Sorunuz yüklediğiniz belgeyle ilgisizse model kibarca uyarır, sonra yine de yardımcı olur.
  • Çapraz hafıza — Aynı esas/karar numarası veya benzer konu başka bir klasör/sohbette geçiyorsa, "Çalışma alanınızdaki '…' kaydında benzer bir durum var" diyerek sizi yönlendirir.
  • Skills (uzmanlık yönergeleri) — skills/ dizinindeki, YAML başlık + markdown gövdeden oluşan oyun kitapları (hukuki emsal araştırması, belge analizi, mali müşavirlik, ihale ve daha fazlası) bağlama göre seçilip modele enjekte edilir. Yeni bir skills/<ad>/SKILL.md ekleyerek modeli kolayca yeni bir uzmanlıkla donatabilirsiniz.
  • Durdurma — Yanıt üretilirken ⏹ durdurma düğmesiyle anında iptal edebilirsiniz.

🔀 Gateway & Sistem Paneli

Merkezi bir LLM Gateway tüm model çağrılarını yönetir:

  • Otomatik failover — Birincil model hata, zaman aşımı veya boş yanıt verirse, tanımladığınız yedek modellere sırayla otomatik geçilir (ör. yerel Ollama → Ollama Cloud → OpenRouter). Yanıtta hangi modelin kullanıldığı ve yedeğe geçilip geçilmediği gösterilir.
  • Metrikler — Sağlayıcı başına başarı/başarısızlık/ortalama gecikme.
  • Reasoning modelleri (gpt-oss, minimax, deepseek…) için token bütçesi otomatik ayarlanır → "boş yanıt" sorunu giderilir.

Sağ üstteki ▦ Sistem düğmesi üç sekme sunar:

Sekmeİçerik
🔀 GatewayYedek model (failover) yapılandırması + canlı sağlayıcı metrikleri
⚡ Skills9 uzmanlık yönergesini tek tek aç/kapat
🧰 Araçlar31 MCP aracının kategori bazında kataloğu (aktif/pasif)

🛠️ Araçlar (Tools)

AraçAçıklama
search_bedesten_unifiedYargıtay/Danıştay/yerel/istinaf birleşik arama (court_types)
get_bedesten_documentKarar tam metni (document_id)
search_anayasa_unifiedAnayasa Mahkemesi (bireysel başvuru / itiraz / genel kurul)
search_kik_v2_decisionsKİK kararları (uyuşmazlık / idari / onarım)
search_rekabet_kurumu · search_sayistay_unifiedRekabet Kurumu · Sayıştay
search_kvkk_decisions · search_bddk_decisionsKVKK · BDDK
search_sigorta_tahkim · search_uyusmazlik · search_emsalSigorta Tahkim · Uyuşmazlık · EMSAL

Bedesten mahkeme kodları: YARGITAYKARARI, DANISTAYKARAR, YERELHUKUK, ISTINAFHUKUK, KYB

AraçAçıklama
search_resmi_gazete · get_daily_bulletin · get_recent_mali_changesResmi Gazete arama / günlük bülten / son N gün
search_gib_sirkuler · get_tax_calendarGİB sirküleri · vergi takvimi
check_efatura_taxpayerVKN/TCKN ile e-Fatura mükellef sorgulama
get_asgari_ucret · get_prim_matrahiAsgari ücret · SGK prim matrahı
get_turmob_pratik_bilgiler · get_ismmmo_pratik_bilgilerTÜRMOB · İSMMMO pratik bilgiler
AraçAçıklama
search_tenders · get_recent_tenders · search_ilan_adsEKAP ihale arama · son N gün · resmi ilanlar
get_bist_stock · get_fx_rates · get_cryptoBIST hisse · döviz · kripto
check_healthTüm modüllerin durumu

Örnek sorular

"Yargıtay 'kira tespiti' kararlarını ara ve emsalleri özetle"
"2025 asgari ücret brüt/net ve SGK prim oranları"
"GİB sirkülerlerinde 'KDV tevkifatı' ara"
"Ankara'daki aktif yapım ihaleleri"
"BIST THYAO ve güncel döviz kurları"

🏗️ Mimari

turkiye-mcp/
├── app.py            # ASGI uygulaması: dashboard arayüzü + tüm endpoint'ler + MCP mount
├── workspace.py      # Sunucu taraflı klasör / oturum / dosya kalıcılığı (JSON)
├── local_run.py      # Masaüstü giriş noktası: sunucu + pywebview penceresi + tray
├── turkiye_mcp.spec  # PyInstaller derleme spec'i
├── uyap_module/      # UYAP EYP/UDF belge ayrıştırıcı
└── *_mcp_module/ , *_module/   # Her veri kaynağı için ayrı modül (graceful loading)
  • Graceful loading: Her modül bağımsız yüklenir; biri başarısız olursa diğerleri çalışmaya devam eder (MODULES_AVAILABLE).
  • Kalıcılık: Çalışma alanı verisi %LOCALAPPDATA%\TurkiyeMCP\workspace altında saklanır (TURKIYE_MCP_DATA_DIR ile değiştirilebilir).
  • Transport: Web dashboard (/), JSON sağlık (/health), REST API (/api/*), MCP SSE (/sse).

Önemli ortam değişkenleri

DeğişkenVarsayılanAçıklama
PORT8080Sunucu portu
TURKIYE_MCP_DATA_DIR%LOCALAPPDATA%\TurkiyeMCPÇalışma alanı veri dizini
TURKIYE_MCP_LOCAL—1 ise yerel mod (keyring ile anahtar saklama)

📦 Sürüm & Derleme (CI/CD)

EXE derlemesi GitHub Actions ile otomatiktir. Yeni sürüm yayınlamak için tek yapılması gereken bir etiket (tag) göndermektir:

# pyproject.toml ve release_notes.md güncellendikten sonra
git tag v1.5.0
git push origin v1.5.0

v* etiketi push edildiğinde build-exe.yml Windows'ta EXE'yi derler, release_notes.md ile bir GitHub Release oluşturur ve TurkiyeMCP.exe'yi asset olarak yükler.

Yerel derleme:

pip install pyinstaller
python -m PyInstaller turkiye_mcp.spec --noconfirm --clean
# çıktı: dist/TurkiyeMCP.exe

EXE komut satırı seçenekleri

TurkiyeMCP.exe              # GUI ile başlat
TurkiyeMCP.exe --no-gui     # Sadece sunucu
TurkiyeMCP.exe --browser    # Tarayıcıda aç
TurkiyeMCP.exe --port 9090  # Farklı port
TurkiyeMCP.exe --debug      # Konsol penceresini göster

📜 Lisans

Ticari Olmayan Kullanım Lisansı — bkz. LICENSE.

Bu yazılım yalnızca kişisel ve ticari olmayan amaçlarla ücretsiz kullanılabilir. Satılması, kiralanması, bir ürün/hizmet olarak pazarlanması veya herhangi bir biçimde maddi kazanç sağlanması yasaktır. Ticari kullanım için telif hakkı sahibinden yazılı izin gerekir.

🙏 Teşekkürler


Ver o original no GitHub

Bom para

Relacionados