# Hukuk Agent

> Türk hukuku doküman asistanı — Claude Code için MCP server + skill. Dilekçe, sözleşme, ihtar, beyan taslakları; tazminat ve harç hesaplama; yerel PII koruması.

- **Type:** MCP server
- **Install:** `agentstack add mcp-demwick-hukuk-agent`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [demwick](https://agentstack.voostack.com/s/demwick)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [demwick](https://github.com/demwick)
- **Source:** https://github.com/demwick/hukuk-agent

## Install

```sh
agentstack add mcp-demwick-hukuk-agent
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# hukuk-agent

Türk hukuku doküman asistanı. [Claude Code](https://claude.com/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](https://www.mevzuat.gov.tr), [karararama.yargitay.gov.tr](https://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](https://pnpm.io)
- [Claude Code](https://claude.com/claude-code)

## Kurulum

```bash
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:

```bash
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

```bash
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](https://github.com/demwick)
- **Source:** [demwick/hukuk-agent](https://github.com/demwick/hukuk-agent)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-demwick-hukuk-agent
- Seller: https://agentstack.voostack.com/s/demwick
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.