Hukuk MCP

# Hukuk MCP

Yerel MCP sunucusu: kamu Türk mevzuatı ve mahkeme/kurul kararlarını AI istemcilerine bağlar; dilekçe taslağı ve UYAP UDF üretir.

UYAP avukat girişi, abonelik ve web sitesi yoktur. Kişisel dava dosyası indirmez. Üretilen metin hukuki tavsiye değildir.

Ön koşul

uv kurulu olsun (Python 3.11+ otomatik gelir).

powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"

Related MCP server: Türk Hukuk AI MCP

Tek satır kurulum (uvx)

GitHub’dan doğrudan çalışır; klasör kopyalamaya gerek yok.

uvx --from git+https://github.com/berkebeydag/hukuk-mcp.git hukuk-mcp

Cursor

Settings → MCP veya proje .cursor/mcp.json:

{
  "mcpServers": {
    "hukuk": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/berkebeydag/hukuk-mcp.git",
        "hukuk-mcp"
      ]
    }
  }
}

Codex (CLI / IDE)

~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml):

[mcp_servers.hukuk]
command = "uvx"
args = [
  "--from",
  "git+https://github.com/berkebeydag/hukuk-mcp.git",
  "hukuk-mcp"
]
startup_timeout_sec = 45

veya:

codex mcp add hukuk -- uvx --from git+https://github.com/berkebeydag/hukuk-mcp.git hukuk-mcp

Claude Desktop / Claude Code

Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hukuk": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/berkebeydag/hukuk-mcp.git",
        "hukuk-mcp"
      ]
    }
  }
}

OpenCode

opencode.json / ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hukuk": {
      "type": "local",
      "command": [
        "uvx",
        "--from",
        "git+https://github.com/berkebeydag/hukuk-mcp.git",
        "hukuk-mcp"
      ],
      "enabled": true
    }
  }
}

Hazır kopyalar: examples/.

Geliştirici kurulumu

git clone https://github.com/berkebeydag/hukuk-mcp.git
cd hukuk-mcp
uv sync
uv run hukuk-mcp

Yerel klasörle Cursor:

{
  "mcpServers": {
    "hukuk": {
      "command": "uv",
      "args": ["run", "--directory", "C:\\\\path\\\\to\\\\hukuk-mcp", "hukuk-mcp"]
    }
  }
}

Örnek sorular

• TMK 166 madde metnini getir

• 4721 sayılı kanunu bul

• Yargıtay boşanma kararlarından son örnekleri ara, esas ve karar no ile yaz

• KİK 2025/UH.II-1801 kararını getir

• Bu cevap dilekçesini UDF olarak kaydet

Araçlar

Karar numarası uydurulmaz: önce search_*, sonra get_*. UDF imzasızdır.

Semantik sıralama (isteğe bağlı — OpenCode Go)

Anahtar yoksa eski haliyle çalışır: kamu API + kelime (lexical) sıralama. Codex/Claude zaten listedeki sonuçları anlamca seçebilir.

OPENCODE_API_KEY varsa ekstra: sonuçlar chat’e gitmeden önce Muse Spark 1.3 Contributor ile yeniden sıralanır; dolu/hata olursa DeepSeek V4.1 Flash. Yerel model gerekmez.

Cursor MCP örneği (env ekleyerek):

"env": {
  "OPENCODE_API_KEY": "sk-...",
  "OPENCODE_BASE_URL": "https://opencode.ai/zen/go/v1",
  "RERANK_MODEL": "muse-spark-1.3-contributor",
  "RERANK_FALLBACK_MODEL": "deepseek-v4.1-flash"
}

Codex config.toml:

[mcp_servers.hukuk.env]
OPENCODE_API_KEY = "sk-..."
OPENCODE_BASE_URL = "https://opencode.ai/zen/go/v1"
RERANK_MODEL = "muse-spark-1.3-contributor"
RERANK_FALLBACK_MODEL = "deepseek-v4.1-flash"

Muse Contributor, OpenCode koşullarına göre prompt’ları eğitimde kullanabilir. Bu, milyonlarca kararlık özel indeksin yerine geçmez.

Sınırlar

Kamu sitelerinin hız limitine uyulur. Özel indeks yoktur. KİK ekapv2 AES anahtarı kopyalanmaz (kamu EKAP formu). Sayıştay HTTPS bazı ağlarda TLS reset verir; tarayıcı linki döner.

Test

uv sync --group dev
uv run pytest tests/test_local.py

Lisans

MIT