Yargi Mcp

Yargı MCP: Türk Hukuk Kaynakları için MCP Sunucusu

> ## ✨ Profesyonel Sürüm Hazır: Yargı MCP Pro > > Mevzuat ve içtihatı tek bir MCP sunucusunda birleştiren profesyonel sürüm yayında: > > 👉 https://yargi.betaspacestudio.com

> ## 🚨 SUNUCU YENİ ADRESE TAŞINDI > > Yeni Remote MCP adresi: https://yargimcp.surucu.dev/mcp > > Eski adres (https://yargimcp.fastmcp.app/mcp) artık kullanım dışıdır — yalnızca taşındığını bildiren bir uyarı tool'u döner. > > Yapmanız gereken: MCP istemcinizdeki (Claude Desktop, 5ire, Google Antigravity, ChatGPT vb.) sunucu URL'sini yukarıdaki yeni adresle güncelleyin.

Word'den UDF'ye profesyonel dönüşüm için yeni uygulamam udfcevir.com adresinde!

[](https://www.star-history.com/#saidsurucu/yargi-mcp&Date)

Bu proje, çeşitli Türk hukuk kaynaklarına (Yargıtay, Danıştay, Emsal Kararlar, Uyuşmazlık Mahkemesi, Anayasa Mahkemesi - Norm Denetimi ile Bireysel Başvuru Kararları, Kamu İhale Kurulu Kararları, Rekabet Kurumu Kararları, Sayıştay Kararları, KVKK Kararları, BDDK Kararları, GİB Özelgeleri ve Sigorta Tahkim Komisyonu Kararları) erişimi kolaylaştıran bir FastMCP sunucusu oluşturur. Bu sayede, bu kaynaklardan veri arama ve belge getirme işlemleri, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları (örneğin Claude Desktop veya 5ire) ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.

---

🚀 5 Dakikada Başla (Remote MCP)

✅ Kurulum Gerektirmez! Hemen Kullan!

🔗 Remote MCP Adresi: https://yargimcp.surucu.dev/mcp

> ⚠️ Eski adres https://yargimcp.fastmcp.app/mcp artık kullanım dışıdır — yalnızca taşındığını bildiren bir uyarı tool'u döner. Lütfen yukarıdaki yeni adresi kullanın.

Claude Desktop ile Kullanım (Ücretli abonelik gerekir)

1. Claude Desktop'ı açın
2. Settings → Connectors → Add Custom Connector
3. Bilgileri girin:

• Name: Yargı MCP
• URL: https://yargimcp.surucu.dev/mcp

1. Add butonuna tıklayın
2. Hemen kullanmaya başlayın! 🎉

Google Antigravity ile Kullanım (Lokal uv Kurulumu — Kopyala-Yapıştır)

> Ön Gereksinimler: Bilgisayarınızda Python, uv (kurulum) ve Node.js (indir) kurulu olmalı. (Node.js yalnızca aşağıdaki kurulum komutunu çalıştırmak için gerekir; MCP'yi uvx çalıştırır.)

Aşağıdaki bloğun tamamını terminale yapıştırın. Komut, Antigravity'nin okuduğu ~/.gemini/config/mcp_config.json dosyasını sizin yerinize oluşturur/günceller (varsa diğer sunucularınız korunur):

macOS / Linux (Terminal):

node -  "+file);
YARGI

Windows (PowerShell):

@'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".gemini","config"),file=path.join(dir,"mcp_config.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcpServers!=="object"||cfg.mcpServers===null)cfg.mcpServers={};
cfg.mcpServers["yargi-mcp"]={command:"uvx",args:["yargi-mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp eklendi -> "+file);
'@ | node -

Komut yargi-mcp eklendi -> ... çıktısını verdiğinde kurulum tamamlanmıştır. Antigravity'yi (açıksa kapatıp) yeniden başlatın; yargi-mcp araçları otomatik yüklenir.

> 💡 İpucu: Lokal kurulumda hukuk kaynaklarına erişim doğrudan bilgisayarınızda uvx yargi-mcp ile çalışır; uzaktan sunucuya ihtiyaç duymaz.

Remote MCP Sorun Giderme

https://yargimcp.surucu.dev/mcp bir web sayfası değil, Streamable HTTP MCP uç noktasıdır. Tarayıcıda açınca veya düz curl ile GET isteği atınca 406 Not Acceptable ve Client must accept text/event-stream benzeri bir yanıt görmek normaldir; bu, sunucunun kapalı olduğu anlamına gelmez. MCP istemcisi Accept: application/json, text/event-stream başlığıyla JSON-RPC isteği göndermelidir.

Hızlı sağlık kontrolü için tarayıcıda şu adresleri açabilirsiniz:

• https://yargimcp.surucu.dev/health — servis sağlık durumu

Claude.ai veya başka bir istemci "araç yok" gibi davranırsa:

1. Connector'ı kaldırıp yeniden ekleyin.
2. URL olarak önce https://yargimcp.surucu.dev/mcp deneyin; istemciniz yönlendirmeleri takip etmiyorsa https://yargimcp.surucu.dev/mcp/ deneyin.
3. Eski https://yargimcp.fastmcp.app/mcp adresinin istemci ayarlarında veya önbellekte kalmadığından emin olun.
4. İstemcinin remote/Streamable HTTP MCP desteklediğini ve text/event-stream kabul ettiğini kontrol edin.

---

🎯 Temel Özellikler

🚀 YÜKSEK PERFORMANS OPTİMİZASYONU: Bu MCP sunucusu %61.8 token azaltma ile optimize edilmiştir (8,692 token tasarrufu). Claude AI ile daha hızlı yanıt süreleri ve daha verimli etkileşim sağlar.

• Çeşitli Türk hukuk veritabanlarına programatik erişim için standart bir MCP arayüzü.
• Kapsamlı Mahkeme Daire/Kurul Filtreleme: 79 farklı daire/kurul filtreleme seçeneği
• Dual/Triple API Desteği: Her mahkeme için birden fazla API kaynağı ile maksimum kapsama
• Kapsamlı Tarih Filtreleme: Tüm Bedesten API araçlarında ISO 8601 formatında tarih aralığı filtreleme
• Kesin Cümle Arama: Tüm Bedesten API araçlarında çift tırnak ile tam cümle arama desteği
• Aşağıdaki kurumların kararlarını arama ve getirme yeteneği:
• Yargıtay: Detaylı kriterlerle karar arama ve karar metinlerini Markdown formatında getirme. Dual API (Ana + Bedesten) + 52 Daire/Kurul Filtreleme + Tarih & Kesin Cümle Arama (Hukuk/Ceza Daireleri, Genel Kurullar)
• Danıştay: Anahtar kelime bazlı ve detaylı kriterlerle karar arama; karar metinlerini Markdown formatında getirme. Triple API (Keyword + Detailed + Bedesten) + 27 Daire/Kurul Filtreleme + Tarih & Kesin Cümle Arama (İdari Daireler, Vergi/İdare Kurulları, Askeri Yüksek İdare Mahkemesi)
• Yerel Hukuk Mahkemeleri: Bedesten API ile yerel hukuk mahkemesi kararlarına erişim + Tarih & Kesin Cümle Arama
• İstinaf Hukuk Mahkemeleri: Bedesten API ile istinaf mahkemesi kararlarına erişim + Tarih & Kesin Cümle Arama
• Kanun Yararına Bozma (KYB): Bedesten API ile olağanüstü kanun yoluna erişim + Tarih & Kesin Cümle Arama
• Emsal (UYAP): Detaylı kriterlerle emsal karar arama ve karar metinlerini Markdown formatında getirme.
• Uyuşmazlık Mahkemesi: Form tabanlı kriterlerle karar arama ve karar metinlerini (URL ile erişilen) Markdown formatında getirme.
• Anayasa Mahkemesi (Norm Denetimi): Kapsamlı kriterlerle norm denetimi kararlarını arama; uzun karar metinlerini (5.000 karakterlik) sayfalanmış Markdown formatında getirme.
• Anayasa Mahkemesi (Bireysel Başvuru): Kapsamlı kriterlerle bireysel başvuru "Karar Arama Raporu" oluşturma ve listedeki kararların metinlerini (5.000 karakterlik) sayfalanmış Markdown formatında getirme.
• KİK (Kamu İhale Kurulu): Çeşitli kriterlerle Kurul kararlarını arama; uzun karar metinlerini (varsayılan 5.000 karakterlik) sayfalanmış Markdown formatında getirme.
• Rekabet Kurumu: Çeşitli kriterlerle Kurul kararlarını arama; karar metinlerini Markdown formatında getirme.
• Sayıştay: 3 karar türü ile kapsamlı denetim kararlarına erişim + 8 Daire Filtreleme + Tarih Aralığı & İçerik Arama (Genel Kurul yorumlayıcı kararları, Temyiz Kurulu itiraz kararları, Daire ilk derece denetim kararları)
• KVKK (Kişisel Verilerin Korunması Kurulu): Brave Search API ile veri koruma kararlarını arama; uzun karar metinlerini (5.000 karakterlik) sayfalanmış Markdown formatında getirme + Türkçe Arama + Site Hedeflemeli Arama (kvkk.gov.tr kararları)
• BDDK (Bankacılık Düzenleme ve Denetleme Kurumu): Bankacılık düzenleme kararlarını arama; karar metinlerini Markdown formatında getirme + Optimized Search + "Karar Sayısı" Targeting + Spesifik URL Filtreleme (bddk.org.tr/Mevzuat/DokumanGetir)
• GİB (Gelir İdaresi Başkanlığı) Özelgeleri: Resmi vergi özelgelerini arama (18.000+ özelge: KDV, Kurumlar, Gelir, ÖTV, Damga vb.); tam metni sayfalanmış Markdown formatında getirme + Keyword + Özelge No + Kanun No + Tarih Aralığı + Otomatik ISO 8601 Dönüşümü + Metadata Başlık Bloğu
• Sigorta Tahkim Komisyonu: Hakem Karar Dergisi (64 sayı, 2010-2025) içindeki sigorta tahkim kararlarını arama; dergi PDF'lerini Markdown formatında getirme + Sayı İçi Karar Arama + Türkçe Büyük/Küçük Harf Desteği + Relevance Scoring

• Karar metinlerinin daha kolay işlenebilmesi için Markdown formatına çevrilmesi.
• Claude Desktop uygulaması ile fastmcp install komutu kullanılarak kolay entegrasyon.
• Yargı MCP artık 5ire gibi Claude Desktop haricindeki MCP istemcilerini de destekliyor!

---

🚀 Claude Haricindeki Modellerle Kullanmak İçin Çok Kolay Kurulum (Örnek: 5ire için)

Bu bölüm, Yargı MCP aracını 5ire gibi Claude Desktop dışındaki MCP istemcileriyle kullanmak isteyenler içindir.

• Python Kurulumu: Sisteminizde Python 3.11 veya üzeri kurulu olmalıdır. Kurulum sırasında "Add Python to PATH" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. Buradan indirebilirsiniz.
• Git Kurulumu (Windows): Bilgisayarınıza git yazılımını indirip kurun. "Git for Windows/x64 Setup" seçeneğini indirmelisiniz.
• uv Kurulumu:
• Windows Kullanıcıları (PowerShell): Bir CMD ekranı açın ve bu kodu çalıştırın: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
• Mac/Linux Kullanıcıları (Terminal): Bir Terminal ekranı açın ve bu kodu çalıştırın: curl -LsSf https://astral.sh/uv/install.sh | sh
• Microsoft Visual C++ Redistributable (Windows): Bazı Python paketlerinin doğru çalışması için gereklidir. Buradan indirip kurun.
• İşletim sisteminize uygun 5ire MCP istemcisini indirip kurun.
• 5ire'ı açın. Workspace -> Providers menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
• Tools menüsüne girin. +Local veya New yazan butona basın.
• Tool Key: yargimcp
• Name: Yargı MCP
• Command:

`` uvx yargi-mcp ``

• Save butonuna basarak kaydedin.

• Şimdi Tools altında Yargı MCP'yi görüyor olmalısınız. Üstüne geldiğinizde sağda çıkan butona tıklayıp etkinleştirin (yeşil ışık yanmalı).
• Artık Yargı MCP ile konuşabilirsiniz.

---

⚙️ Claude Desktop Lokal Kurulumu (Kopyala-Yapıştır)

> Ön Gereksinimler: Bilgisayarınızda Python, uv (kurulum), Node.js (indir) ve (Windows için) Microsoft Visual C++ Redistributable kurulu olmalı. (Node.js yalnızca aşağıdaki kurulum komutunu çalıştırmak için gerekir; MCP'yi uvx çalıştırır.)

Aşağıdaki bloğun tamamını terminale yapıştırın. Komut, Claude Desktop'ın claude_desktop_config.json dosyasını sizin yerinize oluşturur/günceller (varsa diğer sunucularınız korunur):

macOS / Linux (Terminal):

node -  "+file);
YARGI

Windows (PowerShell):

@'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(process.env.APPDATA||path.join(os.homedir(),"AppData","Roaming"),"Claude");
const file=path.join(dir,"claude_desktop_config.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcpServers!=="object"||cfg.mcpServers===null)cfg.mcpServers={};
cfg.mcpServers["yargi-mcp"]={command:"uvx",args:["yargi-mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp eklendi -> "+file);
'@ | node -

Komut yargi-mcp eklendi -> ... çıktısını verdiğinde kurulum tamamlanmıştır. Claude Desktop'ı tamamen kapatıp yeniden başlatın; yargi-mcp araçları otomatik yüklenir.

---

Manuel alternatif: Claude Desktop Settings → Developer → Edit Config menüsünden claude_desktop_config.json dosyasını açıp mcpServers altına ekleyebilirsiniz:

{
  "mcpServers": {
    "yargi-mcp": {
      "command": "uvx",
      "args": ["yargi-mcp"]
    }
  }
}

---

🌟 Gemini CLI ile Kullanım

Yargı MCP'yi Gemini CLI ile kullanmak için:

1. Ön Gereksinimler: Python, uv, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.

1. Gemini CLI ayarlarını yapılandırın:

Gemini CLI'ın ayar dosyasını düzenleyin:

• macOS/Linux: ~/.gemini/settings.json
• Windows: %USERPROFILE%\.gemini\settings.json

Aşağıdaki mcpServers bloğunu ekleyin: ``json { "theme": "Default", "selectedAuthType": "###", "mcpServers": { "yargi_mcp": { "command": "uvx", "args": [ "yargi-mcp" ] } } } ``

Yapılandırma açıklamaları:

• "yargi_mcp": Sunucunuz için yerel bir isim
• "command": uvx komutu (uv'nin paket çalıştırma aracı)
• "args": GitHub'dan doğrudan Yargı MCP'yi çalıştırmak için gerekli argümanlar

1. Kullanım:

• Gemini CLI'ı başlatın
• Yargı MCP araçları otomatik olarak kullanılabilir olacaktır
• Örnek komutlar:
• "Yargıtay'ın mülkiyet hakkı ile ilgili son kararlarını ara"
• "Danıştay'ın imar planı iptaline ilişkin kararlarını bul"
• "Anayasa Mahkemesi'nin ifade özgürlüğü kararlarını getir"

---

🧠 Semantik Arama (Opsiyonel)

Yargı MCP, semantik arama özelliği ile kararları anlamsal olarak sıralayabilir. Opsiyoneldir; iki yoldan biri yapılandırıldığında otomatik etkinleşir:

• Yerel (önerilen, ücretsiz): kendi makinenizdeki OpenAI-uyumlu embedding sunucusu (HuggingFace TEI, llama.cpp, Ollama, vLLM, LM Studio…)
• Hosted: OpenRouter API anahtarı

Semantik Arama Nasıl Çalışır?

1. initial_keyword ile Bedesten API'den 100 karar çekilir
2. query ile bu kararlar embedding modeli kullanılarak anlamsal olarak sıralanır
3. En alakalı kararlar döndürülür

Önerilen Türkçe Kurulumu (Yerel — multilingual-e5-large)

intfloat/multilingual-e5-large Türkçe için kıyas ettiğimiz açık kaynak modeller arasında en iyilerinden. HuggingFace'in Text Embeddings Inference (TEI) sunucusuyla tek komutta ayağa kalkar ve OpenAI-uyumlu API sunar:

docker run -p 8080:80 ghcr.io/huggingface/text-embeddings-inference:latest \
    --model-id intfloat/multilingual-e5-large

Sonra Yargı MCP'ye şu env vars'ları geçirin:

EMBEDDING_PROVIDER=local
LOCAL_EMBEDDING_BASE_URL=http://localhost:8080/v1
LOCAL_EMBEDDING_MODEL=intfloat/multilingual-e5-large
LOCAL_EMBEDDING_DIMENSION=1024
EMBEDDING_PROMPT_STYLE=e5

> ⚠️ Önemli: EMBEDDING_PROMPT_STYLE=e5 şart — e5 modelleri query: / passage: öneki bekleyecek şekilde eğitilmiştir; yanlış önek sessizce kaliteyi düşürür.

Claude Desktop örneği (yerel TEI)

{
  "mcpServers": {
    "Yargı MCP": {
      "command": "uvx",
      "args": ["yargi-mcp"],
      "env": {
        "EMBEDDING_PROVIDER": "local",
        "LOCAL_EMBEDDING_BASE_URL": "http://localhost:8080/v1",
        "LOCAL_EMBEDDING_MODEL": "intfloat/multilingual-e5-large",
        "LOCAL_EMBEDDING_DIMENSION": "1024",
        "EMBEDDING_PROMPT_STYLE": "e5"
      }
    }
  }
}

Alternatif 1: Ollama (yerel, daha hafif kurulum)

ollama serve
ollama pull nomic-embed-text   # 768 dim, İngilizce ağırlıklı

EMBEDDING_PROVIDER=local
LOCAL_EMBEDDING_BASE_URL=http://localhost:11434/v1
LOCAL_EMBEDDIN

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [saidsurucu](https://github.com/saidsurucu)
- **Source:** [saidsurucu/yargi-mcp](https://github.com/saidsurucu/yargi-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.