legalize-mcp

legalize-mcp

非官方。 与 legalize-dev 项目无关联，也未获其认可。 官方 legalize-dev MCP 服务正在开发中，将基于 legalize.dev API； 本服务则直接读取公开的 git 法律文本库。

一个 MCP 服务，覆盖 32 个司法辖区（其中 21 个为欧盟成员国）。 一个只读的 Model Context Protocol 服务，基于 legalize-dev 法律文本库——以 law-as-git 形式存储的国家立法：每部法律对应一个 Markdown 文件，每次改革对应一个 Git 提交，每份文件都带有包含 8 个字段的 ELI 风格 frontmatter（Legalize Format Spec v0.2）。此连接器采用 Apache-2.0 许可。

由 Matematic Solutions 构建，属于 eu-legal-mcp 系列。与面向单个国家的 *-eli-mcp 连接器不同，本服务可从单个服务提供多个司法辖区的数据，因为底层法律文本库已统一为一种格式。

存在的理由

每条响应都包含该系列其余连接器所使用的引文约定：

• source_url — 法律自身 frontmatter 中的官方政府来源（例如 boe.es、riigiteataja.ee、legifrance.gouv.fr）。绝不编造。
• github_url — 实际读取的 legalize-dev 副本，可供验证。
• human_readable_citation — "<title> (<identifier>)"。

此服务可自托管，且数据路径精简：除向 GitHub 发送只读 GET 请求外，不会有任何数据离开用户的设备。

司法辖区

欧盟：at be cz de ee es eu fi fr gr ie it lt lu lv nl pl pt ro se sk · 其他：ad ar ch cl co kr li no uk us uy

调用 legalize_list_countries 获取实时列表（添加 eu_only=true 可筛选）。

工具

工具	无需密钥？	用途
legalize_list_countries	✅	列出司法辖区（代码、名称、欧盟标记、仓库）。
legalize_search_laws	需要 GITHUB_TOKEN	在某个国家的法律中进行关键词搜索 → law_id + 摘录。
legalize_get_meta	✅	仅获取 frontmatter（低成本引文核查）。
legalize_get_law	✅	根据 law_id 获取完整元数据和文本；传入 sha= 可获取历史版本。
legalize_list_reforms	✅	获取某部法律的改革时间线（提交）；SHA 可用于 legalize_get_law。
legalize_coverage	声明此连接器覆盖的内容、各类法律文本的收录时间，以及明确说明未覆盖的内容。每项缺口都附带备用方案。

law_id 是 Markdown 文件名（不含扩展名）（例如西班牙宪法对应 BOE-A-1978-31229，爱沙尼亚法律使用数字 ID）。可通过 legalize_search_laws 或官方引文获取；不支持模糊标题查询。

安装

uvx legalize-mcp           # run directly
# or
pip install legalize-mcp

Claude Code（.mcp.json）：

{
  "mcpServers": {
    "legalize": { "command": "uvx", "args": ["legalize-mcp"] }
  }
}

使用 Smart App Control 的 Windows 11

Smart App Control 会阻止未签名的可执行文件，包括 uvx.exe、pip.exe 以及 pip 安装时写入的 legalize-mcp.exe 启动器。python.org 安装程序提供的 python.exe 和 py.exe 均由 Python Software Foundation 签名，因此通过解释器运行模块即可正常使用：

python -m pip install legalize-mcp
python -m legalize_mcp

由于 pip.exe 也会被同样的机制阻止，因此请使用 python -m pip 安装，而不要使用 pip install。如果 python 不在 PATH 中，请使用 Windows 启动器：py -3 -m legalize_mcp。

{ "mcpServers": { "legalize-mcp": { "command": "python", "args": ["-m", "legalize_mcp"] } } }

请勿为了绕过此问题而关闭 Smart App Control——若不重新安装 Windows，就无法重新启用它。

GITHUB_TOKEN（或 GH_TOKEN）是可选的——仅 legalize_search_laws 需要；此外，它还可以解除 legalize_list_reforms 的 GitHub 速率限制。

配置

环境变量	默认值	用途
GITHUB_TOKEN / GH_TOKEN	—	启用代码搜索；解除速率限制。
LEGALIZE_AUDIT_DIR	~/.matematic/audit	JSONL 审计日志位置（用于留存记录）。

治理

每次工具调用都会在 ~/.matematic/audit/legalize-mcp.jsonl 中追加一行（输入哈希、耗时、 状态——不含负载）。所有工具均为只读且具幂等性。请参阅 CONSTITUTION.md。

开发

python -m venv .venv && .venv/Scripts/python -m pip install -e ".[dev]"
.venv/Scripts/python -m pytest -q          # offline unit tests
.venv/Scripts/python -m ruff check src tests

署名

立法数据 © 各国主管机关（请参阅各法律的 source）。语料库由 legalize-dev 项目进行规范化处理。

语料库的许可因国家而异，并非 MIT。 MIT 许可适用于 legalize-dev 的流程和工具。各国仓库所载条款继承自各自的官方来源——legalize-es 遵循 BOE 的再利用条件，要求必须注明来源；legalize-at 采用 CC BY 4.0；其他仓库的条款则各不相同。在使用、引用或再分发文本之前，请先查看对应的国家仓库。 将语料库视为 MIT 许可，会忽略你实际承担的署名义务。

更正由 Enrique Lop（legalize-dev）在 issue #18 中提供，日期为 2026-08-24。 此连接器不会再分发语料库，而是按需读取。