Hukuk Agent

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](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](LICENSE) © 2026 demwick

Source & license

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

• Author: demwick
• Source: demwick/hukuk-agent
• License: MIT

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