eu.ansvar/turkish-law-mcp

平台与服务

by ansvar-systems

通过 MCP 查询土耳其立法资料,支持跨法律法规与具体条款的全文检索。

什么是 eu.ansvar/turkish-law-mcp

通过 MCP 查询土耳其立法资料,支持跨法律法规与具体条款的全文检索。

README

Turkish Law MCP Server

The mevzuat.gov.tr alternative for the AI age.

npm version MCP Registry License GitHub stars CI Daily Data Check Database Provisions

Query 994 Turkish laws -- from KVKK and Anayasa to Siber Guvenlik Kanunu, Turk Ticaret Kanunu, and more -- directly from Claude, Cursor, or any MCP-compatible client.

If you're building legal tech, compliance tools, or doing Turkish legal research, this is your verified reference database.

Built by Ansvar Systems -- Stockholm, Sweden


Why This Exists

Turkish legal research requires navigating mevzuat.gov.tr, Resmi Gazete archives, and scattered regulatory databases. Whether you're:

  • A lawyer validating citations in a contract or filing
  • A compliance officer checking KVKK data protection requirements
  • A legal tech developer building tools on Turkish law
  • A researcher analyzing Turkish legislative structure

...you shouldn't need to navigate a government portal with iframe-embedded Word documents. Ask Claude. Get the exact provision. With context.

This MCP server makes Turkish law searchable, cross-referenceable, and AI-readable.


Quick Start

Use Remotely (No Install Needed)

Connect directly to the hosted version -- zero dependencies, nothing to install.

Endpoint: https://mcp.ansvar.eu/law-tr/mcp

ClientHow to Connect
Claude.aiSettings > Connectors > Add Integration > paste URL
Claude Codeclaude mcp add turkish-law --transport http https://mcp.ansvar.eu/law-tr/mcp
Claude DesktopAdd to config (see below)
GitHub CopilotAdd to VS Code settings (see below)

Claude Desktop -- add to claude_desktop_config.json:

json
{
  "mcpServers": {
    "turkish-law": {
      "type": "url",
      "url": "https://mcp.ansvar.eu/law-tr/mcp"
    }
  }
}

GitHub Copilot -- add to VS Code settings.json:

json
{
  "github.copilot.chat.mcp.servers": {
    "turkish-law": {
      "type": "http",
      "url": "https://mcp.ansvar.eu/law-tr/mcp"
    }
  }
}

Use Locally (npm)

bash
npx @ansvar/turkish-law-mcp

Claude Desktop -- add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

json
{
  "mcpServers": {
    "turkish-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/turkish-law-mcp"]
    }
  }
}

Cursor / VS Code:

json
{
  "mcp.servers": {
    "turkish-law": {
      "command": "npx",
      "args": ["-y", "@ansvar/turkish-law-mcp"]
    }
  }
}

Example Queries

Once connected, just ask naturally:

  • "KVKK Madde 5 ne diyor? Kisisel verilerin islenmesi sartlari nedir?"
  • "What does Article 20 of the Turkish Constitution say about privacy?"
  • "Siber Guvenlik Kanunu'nun amaci nedir?"
  • "Elektronik ticaret ile ilgili Turk mevzuatini bul"
  • "KVKK'da veri sorumlusunun yukumlulukleri nelerdir?"
  • "Find provisions about bilisim suclari in Turkish criminal law"
  • "What are the penalties under Law 5651 for internet regulation violations?"
  • "Turk Ticaret Kanunu'nda elektronik ticaret hukumleri neler?"

What's Included

CategoryCountDetails
Laws (Kanunlar)898 lawsAll in-force Turkish laws from mevzuat.gov.tr
Decree Laws (KHK)63Kanun Hukmunde Kararnameler
Presidential Decrees33Cumhurbaskanligi Kararnameleri
Provisions21,732 articlesFull-text searchable with FTS5
Legal Definitions3,819 termsExtracted from Tanimlar articles
Database Size~49 MBOptimized SQLite, portable
Daily UpdatesAutomatedFreshness checks against mevzuat.gov.tr

Verified data only -- every provision is ingested from the official Cumhurbaskanligi Mevzuat Bilgi Sistemi (mevzuat.gov.tr). Zero LLM-generated content.

Key Laws Included

LawNumberDescription
KVKK6698Personal Data Protection Law
Anayasa2709Constitution of the Republic of Turkey
Siber Guvenlik Kanunu7545Cybersecurity Law
Iklim Kanunu7552Climate Law
Law 56515651Internet Regulation Law
TCK5237Turkish Criminal Code (including cybercrime arts. 243-246)
TTK6102Turkish Commercial Code
E-Commerce Law6563Electronic Commerce Regulation
EHK5809Electronic Communications Law
E-Signature Law5070Electronic Signature Law
Payment Services6493Payment Services and Electronic Money Law

See It In Action

Why This Works

Verbatim Source Text (No LLM Processing):

  • All statute text is ingested from mevzuat.gov.tr official HTML pages
  • Provisions are returned unchanged from SQLite FTS5 database rows
  • Zero LLM summarization or paraphrasing -- the database contains regulation text, not AI interpretations

Smart Context Management:

  • Search returns ranked provisions with BM25 scoring (safe for context)
  • Provision retrieval gives exact text by law number + article number
  • Cross-references help navigate without loading everything at once

Technical Architecture:

code
mevzuat.gov.tr API -> Census -> Ingest -> Parse -> SQLite -> FTS5 snippet() -> MCP response
                        |                   |
                  994 laws enumerated   Article parser (Madde/Gecici Madde/Ek Madde)

Available Tools (8)

Core Legal Research Tools (8)

ToolDescription
search_legislationFTS5 search on 21,732 provisions with BM25 ranking
get_provisionRetrieve specific provision by law name + article number
validate_citationValidate citation against database (zero-hallucination check)
build_legal_stanceAggregate citations from multiple statutes
format_citationFormat citations per Turkish legal conventions
check_currencyCheck if statute is in force, amended, or repealed
get_eu_basisGet EU directives/regulations referenced in Turkish statute
get_provision_eu_basisGet EU law references for specific provision

Data Sources & Freshness

All content is sourced from the authoritative Turkish government legislation portal:

  • mevzuat.gov.tr -- Cumhurbaskanligi Mevzuat Bilgi Sistemi (Presidency Legislation Information System)
  • Resmi Gazete -- Official Gazette of Turkey (for publication dates)

Census-Driven Ingestion

The ingestion pipeline follows a census-first approach:

  1. Census (scripts/census.ts): Calls the MevzuatDatatable API to enumerate all laws
  2. Ingest (scripts/ingest.ts): Fetches each law's full text via the iframe content endpoint
  3. Parse (scripts/lib/parser.ts): Extracts articles (Madde), transitional articles (Gecici Madde), additional articles (Ek Madde), and definitions
  4. Build (scripts/build-db.ts): Compiles all seed files into the SQLite database with FTS5

Automated Freshness Checks (Daily)

A daily GitHub Actions workflow monitors mevzuat.gov.tr for:

CheckMethod
New lawsMevzuatDatatable API pagination
AmendmentsContent hash comparison
Repealed lawsStatus field monitoring

Security

This project uses multiple layers of automated security scanning:

ScannerWhat It DoesSchedule
CodeQLStatic analysis for security vulnerabilitiesWeekly + PRs
SemgrepSAST scanning (OWASP top 10, secrets, TypeScript)Every push
GitleaksSecret detection across git historyEvery push
TrivyCVE scanning on filesystem and npm dependenciesDaily
Socket.devSupply chain attack detectionPRs

See SECURITY.md for the full policy and vulnerability reporting.


Important Disclaimers

Legal Advice

THIS TOOL IS NOT LEGAL ADVICE

Statute text is sourced from official mevzuat.gov.tr publications. However:

  • This is a research tool, not a substitute for professional legal counsel
  • Verify critical citations against primary sources for court filings
  • Amendment tracking may have delays -- always check mevzuat.gov.tr for the latest version
  • Some laws (especially amendment laws) may have 0 parsed provisions if they only modify other statutes

Before using professionally, read: DISCLAIMER.md | PRIVACY.md

Client Confidentiality

Queries go through the Claude API. For privileged or confidential matters, use on-premise deployment. See PRIVACY.md.


Development

Setup

bash
git clone https://github.com/Ansvar-Systems/turkish-law-mcp
cd turkish-law-mcp
npm install
npm run build

Data Management

bash
npm run census                          # Enumerate all laws from mevzuat.gov.tr
npm run ingest                          # Full ingestion (census-driven)
npm run ingest -- --limit 10            # Test with 10 laws
npm run ingest -- --resume              # Resume from where you left off
npm run ingest -- --skip-fetch          # Reuse cached HTML
npm run build:db                        # Rebuild SQLite database
npm run check-updates                   # Check for amendments
npm run drift:detect                    # Detect data drift

Running Locally

bash
npm run dev                                       # Start MCP server
npx @anthropic/mcp-inspector node dist/index.js   # Test with MCP Inspector

Performance

  • Search Speed: <100ms for most FTS5 queries
  • Database Size: ~49 MB (efficient, portable)
  • Ingestion Time: ~9 minutes for full corpus (994 laws)
  • Zero failures: 100% ingestion success rate

Related Projects: Complete Compliance Suite

This server is part of Ansvar's Compliance Suite -- MCP servers that work together for end-to-end compliance coverage:

@ansvar/eu-regulations-mcp

Query 49 EU regulations directly from Claude -- GDPR, AI Act, DORA, NIS2, MiFID II, eIDAS, and more. npx @ansvar/eu-regulations-mcp

@ansvar/swedish-law-mcp

Query 2,415 Swedish statutes directly from Claude -- DSL, BrB, ABL, MB, and more. npx @ansvar/swedish-law-mcp

@ansvar/us-regulations-mcp

Query US federal and state compliance laws -- HIPAA, CCPA, SOX, GLBA, FERPA, and more. npx @ansvar/us-regulations-mcp


Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Priority areas:

  • EU cross-reference extraction (Turkey is an EU candidate country)
  • English translations for key statutes
  • Amendment history tracking
  • Secondary legislation (Yonetmelikler, Tebligler)

Roadmap

  • Full corpus census -- 994 laws enumerated from MevzuatDatatable API
  • Census-driven ingestion -- 21,732 provisions from 994 laws
  • Definition extraction -- 3,819 legal definitions
  • FTS5 full-text search -- unicode61 tokenizer for Turkish text
  • EU cross-reference extraction (KVKK -> GDPR, etc.)
  • Secondary legislation (Yonetmelikler, Tuzukler)
  • English translations for key statutes
  • Historical statute versions (amendment tracking)

Citation

If you use this MCP server in academic research:

bibtex
@software{turkish_law_mcp_2026,
  author = {Ansvar Systems AB},
  title = {Turkish Law MCP Server: Production-Grade Legal Research Tool},
  year = {2026},
  url = {https://github.com/Ansvar-Systems/turkish-law-mcp},
  note = {Comprehensive Turkish legal database with 994 laws and 21,732 provisions}
}

License

Apache License 2.0. See LICENSE for details.

Data Licenses

  • Statutes & Legislation: Cumhurbaskanligi Mevzuat Bilgi Sistemi (Government Public Data)
  • Official Gazette Metadata: Resmi Gazete (public domain)

About Ansvar Systems

We build AI-accelerated compliance and legal research tools for the European market. This MCP server makes Turkish law searchable, cross-referenceable, and AI-readable -- so you can focus on analysis, not navigation.

ansvar.eu -- Stockholm, Sweden


<p align="center"> <sub>Built with care in Stockholm, Sweden</sub> </p>

常见问题

eu.ansvar/turkish-law-mcp 是什么?

通过 MCP 查询土耳其立法资料,支持跨法律法规与具体条款的全文检索。

相关 Skills

MCP构建

by anthropics

Universal
热门

聚焦高质量 MCP Server 开发,覆盖协议研究、工具设计、错误处理与传输选型,适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。

想让 LLM 稳定调用外部 API,就用 MCP构建:从 Python 到 Node 都有成熟指引,帮你更快做出高质量 MCP 服务器。

平台与服务
未扫描114.1k

Slack动图

by anthropics

Universal
热门

面向Slack的动图制作Skill,内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程,适合把创意或上传图片快速做成可直接发送的Slack动画。

帮你快速做出适配 Slack 的动图,内置约束规则和校验工具,少踩上传与播放坑,做表情包和演示都更省心。

平台与服务
未扫描114.1k

MCP服务构建器

by alirezarezvani

Universal
热门

从 OpenAPI 一键生成 Python/TypeScript MCP server 脚手架,并校验 tool schema、命名规范与版本兼容性,适合把现有 REST API 快速发布成可生产演进的 MCP 服务。

帮你快速搭建 MCP 服务与后端 API,脚手架完善、扩展顺手,尤其适合想高效验证服务能力的开发者。

平台与服务
未扫描10.2k

相关 MCP Server

Slack 消息

编辑精选

by Anthropic

热门

Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。

这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点,特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过,它目前只是参考实现,文档有限,不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。

平台与服务
83.4k

by netdata

热门

io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。

这个工具解决了运维人员需要手动检查系统状态的痛点,最适合 DevOps 团队让 Claude 自动分析性能数据。不过,它依赖 NetData 的现有部署,如果你没用过这个监控平台,得先花时间配置。

平台与服务
78.4k

by d4vinci

热门

Scrapling MCP Server 是专为现代网页设计的智能爬虫工具,支持绕过 Cloudflare 等反爬机制。

这个工具解决了爬取动态网页和反爬网站时的头疼问题,特别适合需要批量采集电商价格或新闻数据的开发者。不过,它依赖外部浏览器引擎,资源消耗较大,不适合轻量级任务。

平台与服务
35.4k

评论