hukuk-agent

Türk hukuku doküman asistanı. Claude Code için MCP server + skill mimarisi. Bireysel avukatların dilekçe, sözleşme, ihtar ve beyan taslaklarını hazırlamasına; tazminat ve harç hesaplaması yapmasına yardımcı olur.

Yasal Uyarı

Bu yazılım hukuki tavsiye değildir ve hukuki danışmanlık yerine geçmez. Ürettiği tüm çıktılar taslaktır ve bir avukat tarafından kontrol edilmeden kullanılmamalıdır. Yazılım "olduğu gibi" sunulur; doğruluk, güncellik veya belirli bir amaca uygunluk garantisi vermez. Mevzuat ve içtihat sürekli değişir — kullanmadan önce resmi kaynaklardan (mevzuat.gov.tr, karararama.yargitay.gov.tr) doğrulayın. Kullanımdan doğan sorumluluk tamamen kullanıcıya aittir.

Özellikler

• Çok-dallı mimari — Hub skill dal ve doküman türünü seçer, dal skill'i devralır
• PII koruması — Kişisel veriler (TC kimlik, telefon, IBAN, e-posta, adres) Claude API'ye gitmeden önce yerel olarak anonimleştirilir, çıktıda geri yüklenir
• Lokal çalışma — MCP stdio transport, veri ağ üzerinden gitmez
• Mevzuat araması — SQLite FTS5 ile kanun maddeleri ve Yargıtay içtihatlarında tam metin arama
• Hesaplama araçları — Kıdem/ihbar/fazla mesai/yıllık izin/UBGT tazminatları (4857 s.K.) ve dava harçları (492 s.K.)

Desteklenen dallar ve doküman türleri

Dal	Dilekçe	Sözleşme	İhtar	Beyan
İş Hukuku (4857 s.K.)	9 şablon	4 şablon	4 şablon	4 şablon

Gereksinimler

• Node.js >= 22
• pnpm
• Claude Code

Kurulum

git clone https://github.com/demwick/hukuk-agent.git
cd hukuk-agent
./setup.sh

setup.sh bağımlılıkları kurar, derler, mevzuat veritabanını oluşturur, MCP server'ı ve /hukuk skill'ini Claude Code'a ekler.

Manuel kurulum:

pnpm install
pnpm build
node dist/cli.js init                 # veritabanını oluştur
claude mcp add hukuk-toolkit -- node "$(pwd)/dist/mcp-server/index.js"

Kullanım

Yeni bir Claude Code oturumunda:

/hukuk Müvekkilim 3 yıldır çalışıyor, haksız fesih yapıldı, son maaşı 45000 TL

Akış: Hub dal + doküman türünü sorar → Dal skill devralır → PII anonimleştirilir → Mevzuat araştırılır → (Dilekçe için: tazminat + harç hesaplanır) → Şablon doldurulur → PII geri yüklenir → Taslak teslim edilir.

Mimari

skill/              Hub + dal skill'leri (davranış tanımı)
mcp-server/         MCP server (stdio) — araçlar
  tools/            Ortak + dal-spesifik tool'lar
  lib/              db, pii, hesaplama kütüphaneleri
data/sablonlar/     Doküman şablonları (dal/tür bazlı)
data/*.json         Tavan, kesinti, harç oranları (yıllık güncellenir)
scripts/seed-db.ts  Veritabanı seed

MCP Tool	İşlev
mevzuat_ara	Kanun ve içtihatlarda FTS5 araması
mevzuat_kaydet	Web'den öğrenilen mevzuatı DB'ye kaydetme
sablon_getir	Dal + tür bazlı şablon getirme
is_tazminat_hesapla	Tazminat kalemleri hesaplama
is_harc_hesapla	Dava harcı hesaplama
pii_anonimlestir / pii_geri_yukle	PII koruması

Geliştirme

pnpm dev          # MCP server (tsx, geliştirme)
pnpm test         # testleri çalıştır
pnpm test:watch   # izleme modu
pnpm seed         # veritabanını yeniden oluştur

Yeni hukuk dalı ekleme adımları için CLAUDE.md'ye bakın.

Katkı

Katkılar açıktır. Mevzuat/içtihat eklerken mutlaka resmi kaynaklardan doğrulayın — uydurma madde/içtihat eklemeyin. Yıllık güncellenen değerler (data/tavan.json, data/kesinti-oranlari.json, data/harc-oranlari.json) resmi kaynakla teyit edilmelidir.

Lisans

MIT © 2026 demwick