Türk Hukuk AI MCP

Türk hukukunda içtihat ve mevzuatı birlikte araştıran, Windows üzerinde yerel Qwen 3 1.7B kullanan hafif sistem. Yeni proje deposu: https://github.com/ahmetaliunaall-prog/turk-hukuk-ai-mcp

Çalıştırma

start.cmd dosyasını açın. Yerel arayüz: http://127.0.0.1:8765

Python 3.14, MCP SDK 2.2.0 ve mevcut Ollama kullanılır. Yeni model indirilmez. Ana model qwen3:1.7b; 0.6B seçilmez. Eksik bağımlılıklar için python -m pip install -r requirements.txt; zaten kurulu paketleri yeniden kurmayın. Bu ortamda yalnızca eksik httpx ve hafif HTML dönüştürücü markdownify eklendi.

Netlify arayüzü yerel sunucu çalışırken kullanılabilir. config/local.example.json dosyasını config/local.json olarak kopyalayın ve yalnızca yeni Netlify origin'ini yazın. Netlify arayüzünde Bağlantı ayarları üzerinden yerel uygulamanın gösterdiği oturum kodunu girin. Kod oturum başına yenilenir ve tarayıcı belleğinde tutulur. Tarayıcının yerel ağ erişim izni gerekebilir. HTTPS→localhost kısıtı olan tarayıcılarda yerel arayüzü kullanın. Ollama CORS ayarı değiştirilmez.

Mimari

Model kaynak pasajlarının kimliklerini seçer; birebir alıntı metni kaynak tablosundan alınır. Böylece uzun metni modelin yeniden üretmesi gerekmez. Kaynak sıra puanı sorun/konu/alt konu/kavram/kanun eşleşmeleri, uygun mahkeme/daire ve düşük ağırlıklı tarih sinyaliyle açıklanabilir; ağır embedding kullanılmaz.

Kullanıcı → yerel maskeleme → Qwen hukuki problem/araştırma planı → MCP istemcisi → birleşik MCP → mevcut içtihat/mevzuat istemcileri → tekrar temizleme → bağlamsal sıralama → kaynak metni doğrulama → Qwen alıntı seçimi → kaynaklı araştırma taslağı.

local_ai/: localhost Ollama ve HTTP köprüsü. legal_mcp/: adapter, MCP sunucu/istemci, araştırma, kaynak ve gizlilik katmanları. vendor/: lisanslı kaynak istemcileri. frontend/: bağımlılıksız web arayüzü. config/: yerel ayar örneği. tests/: birim ve canlı testler.

MCP araçları: ictihat_ara, karar_getir, search_mevzuat, get_mevzuat_article_tree, get_mevzuat_article_content. Birleşik sunucu: python -m legal_mcp.server. Modüller ayrı da başlatılabilir: python -m legal_mcp.server ictihat / mevzuat.

Qwen şemalı JSON ile dava türü, konu, alt konu, hukuki sorun, kavramlar, mevzuat önerileri ve çoklu sorgular üretir. Orchestrator bu planı sınırlandırılmış MCP çağrılarına çevirir. Modelin kanun/madde önerileri kaynak sayılmaz. Arama sonuçlarından alınan kimliklerle tam metinler getirilir. Arama sayfası başına 10–20 kaynak; en fazla 3 içtihat sorgusu, 2 mevzuat araştırması. Daha fazla karar sonraki sayfayı getirir; önceki sonuçlarla kalıcı birleşik geçmiş tutulmaz.

Kaynak ve gizlilik sınırları

Modelden gelen serbest hukuki iddia gösterilmez. Yalnızca doğrulanmış kaynak kimliğine bağlı ve kaynak metninde birebir bulunan alıntılar kabul edilir. Kaynak metadata'sı adapter'dan alınır; modelin karar numarası veya tarih üretmesine izin verilmez. SHA-256 ve erişim zamanı kaydedilir; bu yalnızca metnin resmî kaynaktan alınmasını doğrular, kararın kesinleşmesi veya mevzuatın güncelliğini doğrulamaz. Olası çelişkiler iki kaynaktan doğrulanmış alıntılarla inceleme önerisi olarak gösterilir; otomatik hukuki çelişki hükmü verilmez. Kanun/madde ilişkisi yalnızca karar metninde iki belirteç de bulunduğunda aday bağlantıdır; semantik bağ ayrıca incelenmelidir.

Maskeleme T.C. kimlik, telefon, e-posta, IBAN, kart ve etiketli adres/kişi/dosya bilgilerini kapsar. Etiketsiz isimler ve her adres biçimi güvenilir biçimde tespit edilemez: kullanıcı kişileri anonim anlatmalıdır. Sorgular sadece genel hukuki kavramlar olmalıdır; model bu yönde sınırlandırılır ve belirgin kişisel veri taşıyan dış sorgular reddedilir. Kullanıcı olay metni yalnızca yerel Ollama'ya gider. Araştırma geçmişi, olay metni, oturum kodu veya müvekkil belgesi Supabase/Netlify/GitHub'a kaydedilmez. Supabase ilk sürümde gerekli olmadığı için kullanılmaz; mevcut veritabanı değişmez.

Yerel sunucu sadece 127.0.0.1:8765 üzerinde dinler. Host ve origin kontrolü, oturum kodu ve tek araştırma kilidi bulunur. Tünel, public AI endpoint, port yönlendirme, Docker, embedding, vektör veritabanı yok. Dilekçe çıktısı tamamlanacak alanlar ve doğrulanmış kaynak alıntıları içeren araştırma taslağıdır, mahkemeye hazır belge değildir.

Açık kaynak / attribution

• aydincan/turk-hukuku-ictihat-mcp, sürüm 0.4.0, commit 5dac35d11e5a600a66171cf501cf6a635250f71c, MIT, © 2026 Aydın Can Polatkan. Fork: https://github.com/ahmetaliunaall-prog/turk-hukuku-ictihat-mcp. UYAP, Danıştay ve AYM arama/getirme mekanizmaları korunur. MCP v1 FastMCP import'u SDK 2.2 MCPServer olarak uyarlanmıştır. İlgili gizlilik ve sorumluluk metinleri korunur.

• Özgün proje saidsurucu/mevzuat-mcp, © 2025 saidsurucu, MIT. Özgün depo bu çalışma sırasında git ile erişilebilir değildi; turkgent/mevzuat-mcp forkundaki commit 7b2f13ff90e36089278f07518dc607b43003a3d9 kullanılır. Fork: https://github.com/ahmetaliunaall-prog/mevzuat-mcp. Bedesten arama, madde ağacı ve madde getirme payload'ları korunur. Ağır MarkItDown yerine hafif markdownify HTML dönüşümü kullanılır. Eski sunucu fastmcp 2.9.2 kullanıyordu; birleşik adapter SDK 2.2 ile araçları yeniden sunar.

Üçüncü taraf lisansları vendor/*/LICENSE altında aynen korunmuştur. Mevzuat API'sinin başlıksız madde düğümleri için title alanı nullable yapılmıştır; boş başlık yerine model kaynakta olmayan başlık üretmez. Yeni legal_mcp/, local_ai/, arayüz ve test katmanları bu projenin geliştirmeleridir. Kaynak sitelerin erişim koşulları geçerlidir; CAPTCHA/erişim engeli atlatılmaz.

Testler

Küçük modelin alıntısı kaynakla birebir eşleşmezse sistem, hata bilgisini göstererek kaynak metninden doğrudan ilgili pasajları seçer. Bu CPU seçimi hukuki yorum veya semantik doğrulama değildir. İşe iade için resmî API'de teyit edilen 4857, madde 18/19/20 araştırma rehberi kullanılır. Modelin diğer kanun önerileri doğrulanmadan kaynak olarak gösterilmez.

python -m unittest discover -s tests -p "test_*.py" -v

python tests/live.py canlı Ollama, Qwen, MCP araçları, kaynak arama/getirme ve birleşik dilekçe araştırmasını denetler. Canlı veri yoksa test başarılı sayılmaz. Canlı çıktı tests/live-report.json (git tarafından yok sayılır). TEST_REPORT.md son doğrulama durumunu açıklar.

Netlify netlify.toml ile yalnızca frontend/ klasörünü yayınlar. GitHub main değişiklikleri bağlı yeni Netlify projesine deploy edilir. DNS ve özel domain ayarı yapılmaz.