Türk Hukuk AI MCP

Mevcut içtihat ve mevzuat istemcilerini koruyan, Windows'ta yerel Qwen 3 1.7B destekli hukuk araştırma sistemi.

Kullanım

start.cmd veya start.ps1 çalıştırın. Yerel arayüz: http://127.0.0.1:8765. Python 3.14, mevcut MCP 2.2.0 ve Ollama kullanılır; bu geliştirmede paket/model indirilmedi. Ana model qwen3:1.7b ve adresi yalnız 127.0.0.1:11434.

Production: https://turk-hukuk-ai-mcp.netlify.app. Yönetici: /admin.html. Yönetici Supabase hesabıyla giriş yapar ve 12 karakterli anahtar oluşturur. Kullanıcı anahtarı giriş kapısında doğrular. Anahtar yalnız sekme belleğindedir; sayfa yenilenince yeniden girilir.

Netlify araştırması için aynı bilgisayarda yerel sunucu çalışmalıdır. config/local.json içinde izinli Netlify origin'i tanımlanır; örnek local.example.json. Bağlantı ayarlarına yerel uygulamanın gösterdiği geçici oturum kodu girilir. Tarayıcı yerel ağ izni isteyebilir; HTTPS→localhost engelinde yerel arayüz kullanılabilir. Netlify üzerinde yerel Qwen çalışmaz. Tünel veya dışarı açık AI endpoint yoktur.

Related MCP server: mevzuat-mcp

Mimari ve araştırma

frontend/ sade arayüz; local_ai/ Ollama ve localhost köprüsü; legal_mcp/ MCP, planlama, sıralama, kaynak doğrulama ve erişim; vendor/ mevcut lisanslı kaynak istemcileri; supabase/ migration, Edge Function ve SQL testleri.

Yerel maskeleme → MCP bağlantısı → süre sınırlı Qwen kavram desteği → kişisiz hukuk sorguları → sınırlı paralel içtihat/mevzuat araması → metadata ön sıralama → seçilmiş tam metinler → birebir kaynak pasajları → araştırma/dilekçe taslağı.

Qwen 64 token/8 saniyelik plan desteği verir. Yanıt yoksa hukuki terim ailelerinden sınırlı araştırma planı kurulur; bu durum sonuçta açıkça bildirilir. Plan başarılıysa 32 token/4 saniyelik pasaj kimliği seçimi denenir; başarısızsa kaynak metninden birebir pasaj seçilir. Bu yerel seçim hukuki yorum değildir. Modelin önerdiği kanun veya madde kaynak sayılmaz.

MCP araçları korunur: ictihat_ara, karar_getir, search_mevzuat, get_mevzuat_article_tree, get_mevzuat_article_content. Birleşik sunucu python -m legal_mcp.server; ayrı kaynaklar ictihat / mevzuat argümanıyla çalışır.

İçtihat için en fazla 5 farklı kişisiz sorgu, sonuç azsa ek sayfa ve başka mahkeme ailesi araştırılır. Önce 20 sonuçlu metadata aranır; normal araştırmada en fazla 7 karar tam metni seçilir. Mevzuat adı/numarası ve içerik ifadeleri aranır; en fazla 3 kanun ve ilgili madde düğümleri getirilir. Daha fazla karar sonraki sayfayı araştırır. Aynı mahkeme/kimlik tekrarları birleştirilir; aynı belgenin farklı sorgularda bulunması korunur.

Türkçe harf normalizasyonu, kısmi ve yaklaşık eşleşme yalnız sıralamada kullanılır. Konu, alt konu, sorun, kavram, kanun/madde, sorgu, başlık, tam metin, mahkeme/daire ve düşük ağırlıklı tarih puanları gösterilir. Alıntı kabulü yaklaşık değildir: metin kaynağın birebir alt dizisi olmalıdır. Kaynak kartları mahkeme, daire, esas/karar, tarih, puan, ilgili pasaj, resmî bağlantı ve tam metni gösterir. İlerleme gerçek sunucu olaylarından gelir.

Performans

Aynı işe iade araştırması eski sürümde 354.438 saniye, yeni sürümde soğuk 61.868 ve sıcak 30.561 saniye ölçüldü. İlk ölçümde 97 karar ve 17 mevzuat adayı bulundu; 9/9 kaynak doğrulandı. Sıcak ölçüm 10/10 doğrulanmış kaynak verdi. Önceki 20 HTTP denemesine karşı soğuk 23, sıcak 2 deneme: hız kazanımı yalnız çağrı azaltımı değildir; model süresi sınırı, ön seçim, paralellik ve önbellek etkilidir.

Toplam araç eşzamanlılığı 3; UYAP hostunda tek istek ve en az 2.2 saniye aralık vardır. 429 yanıtı geri çekilme ve açık hata üretir. 256 kayıt/300 saniyelik bellek önbelleğinde yalnız kamu kaynakları ve kişisiz arama sonuçları tutulur. Olay, model yanıtı ve araştırma geçmişi önbelleğe alınmaz. 4 GB RAM'de model/MCP başlatma ve disk belleği hâlâ süreyi etkiler; her sorgunun aynı hızda biteceği garanti edilmez.

Supabase ve erişim güvenliği

Mevcut Supabase projesinde yalnız yeni thaimcp_admins, thaimcp_api_keys, thaimcp_usage tabloları kullanılır. Mevcut kişisel site tabloları ve diğer Edge Functions değiştirilmez. Olay metni Supabase'e gönderilmez; sadece erişim anahtarı doğrulaması ve kullanım metadata'sı işlenir.

thaimcp-access Edge Function kriptografik rastgele 12 alfanümerik karakter üretir. Düz anahtar sadece oluşturma/yenileme yanıtında bir kez döner. DB'de SHA-256, 3 karakter önek, etiket, aktiflik, süre sonu, kullanım sayacı/zamanı ve iptal bilgisi bulunur. Liste hash içermez. Yenileme eski anahtarı atomik iptal eder; iptal edilmiş anahtar tekrar açılamaz. Süresi geçmiş/pasif/iptal/geçersiz anahtar reddedilir.

RLS açık, anon/authenticated tablo ve RPC yetkileri kapalıdır. Güvenilir RPC yalnız service_role tarafından çağrılır. Yönetici JWT'si Auth sunucusundan doğrulanır, thaimcp_admins üyeliği DB'de kontrol edilir; frontend yönetici rolü veremez. Publishable key genel ayardır; service key yalnız Edge Function ortamındadır. Yönetici parolası, JWT, service key ve düz erişim anahtarı repoda tutulmaz. Yönetici panelinde oluştur/listeler, aktif/pasif, iptal, yenileme, süre sonu ve kullanım bilgileri vardır.

IP özetiyle 30/dakika, toplam 600/dakika ve araştırma anahtarıyla 10/dakika sunucu sınırı uygulanır. Yerel doğrulama 20/dakikadır. Her araştırmada Edge Function'a yeniden consume çağrılır; frontend kapısını atlamak erişim sağlamaz. Erişim hizmeti yoksa araştırma kapalı kalır. Origin/Host, yerel oturum kodu ve tek araştırma kilidi de korunur.

Gizlilik ve kanıt sınırları

Regex maskeleme T.C. kimlik, telefon, e-posta, IBAN, kart ve etiketli kişi/adres/dosya bilgilerini kapsar; tüm etiketsiz isimleri yakalayamaz. Olayı anonim anlatın. Dış sorgular sadece onaylı kısa hukuk kavramlarıdır; olay yalnız yerel modelde işlenir.

Model karar kimliği, tarih veya serbest hukuki iddia üretemez. Metadata resmî istemciden alınır. SHA-256/erişim zamanı metnin kaynaktan alındığını kanıtlar; hukuki bağlayıcılık veya güncellik garantisi vermez. Kanun-madde ilişkisi kaynakta görünen aday bağlantıdır. Dilekçe tamamlanacak alanlar ve doğrulanmış alıntılar içeren araştırma taslağıdır.

Kurulum ve yayın

Migration: supabase/migrations/202609280001_thaimcp_access.sql; Edge: supabase/functions/thaimcp-access/index.ts. Yönetici Auth kullanıcısı önce oluşturulur, UID thaimcp_admins tablosuna güvenilir sunucu/SQL üzerinden eklenir. Parola admin Auth API ile değiştirilir; repoya yazılmaz. Edge platform JWT anahtarı denetimi kapalıdır çünkü publishable key desteklenir; yönetici JWT denetimi kod içinde zorunludur. supabase/config.toml ayarı bunu belgelendirir.

frontend/config.js ve config/access.public.json yalnız Supabase URL/publishable key içerir. Özel yerel ayarlar config/access.json ignore kapsamındadır. Edge service kimliğini Supabase ortamından alır. Netlify yalnız frontend/ yayınlar; main bağlı otomatik deploy kullanılır. DNS/domain ayarları değiştirilmez.

Kontroller

python -m unittest discover -s tests -p "test_*.py" -v
node tests/security.test.mjs
python tests/live.py
python tests/access_live.py
python tests/benchmark.py
node --check frontend/app.js
node --check frontend/admin.js

SQL bütünlük/yetki kontrolleri supabase/tests/access.sql içinde rollback ile çalışır. Canlı kaynak testleri sonuç yoksa başarılı sayılmaz. Model zaman aşımı fallback başarı olarak saklanmaz; kaynak araştırmasının başarısı ayrı raporlanır. Son ölçümler tests/performance.json, açıklamalar TEST_REPORT.md ve IMPROVEMENTS.md içindedir.

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.