jp-eli-mcp

jp-eli-mcp

面向日本官方 e-Gov 法律搜索 API（laws.e-gov.go.jp）的 MCP 服务，由数字厅运营。它可搜索、获取并引用国家立法——法律、内阁政令和省令——并为每条响应提供可验证的引用。

这是 MateMatic eu-legal-mcp 生产线的一部分，现已扩展至亚洲。与 18 个欧盟/欧洲经济区连接器采用相同的引用约定（稳定标识符 + 易读引用 + 来源 URL），并针对没有 ELI 体系的司法管辖区进行了调整。

范围。 可按法律标题搜索（jp_search_laws），或按全文关键词搜索（jp_search_by_keyword）；获取特定条文（jp_get_article）或全文（jp_get_full_text，对于《民法》等超长法律会截断）。每条响应都包含 dataset_note。

许可。 e-Gov 法律数据是日本政府以开放数据形式发布的官方公共信息（无需密钥，REST/JSON）。此连接器会注明来源并附上 source_url，转发这些数据。

工具

工具	功能
jp_search_laws	按（部分）标题搜索法律。
jp_search_by_keyword	跨所有法律进行全文搜索，并显示高亮片段。
jp_get_law	根据 law_id 获取法律元数据：标题、法律编号、公布日期。
jp_get_article	根据 law_id 和 article_num 获取法律中一条条文的文本。
jp_get_full_text	获取法律全文（约 300,000 个字符后截断）。
jp_coverage	说明此连接器涵盖的内容、各类数据的采集时间，以及明确列出未涵盖的内容。每个缺口都会提供回退方案。

每条响应都遵循以下约定：eli_uri（日本没有 ELI——这里使用的是稳定的 e-Gov 查看器 URL，例如 https://laws.e-gov.go.jp/law/129AC0000000089，参见 eli_note）、human_readable_citation（例如 民法（明治二十九年法律第八十九号））和 source_url（机器可读的 API URL）。

安装

尚未发布到 PyPI——首个版本发布前，请从源代码安装：

git clone https://github.com/matematicsolutions/jp-eli-mcp
cd jp-eli-mcp
pip install -e .

发布后，可通过 uvx jp-eli-mcp 安装。

通过环境变量配置：

• JP_ELI_BASE_URL - 默认值为 https://laws.e-gov.go.jp/api/2
• JP_ELI_CACHE_DIR - 默认值为 ~/.matematic/cache/jp-eli
• JP_ELI_AUDIT_DIR - 默认值为 ~/.matematic/audit

无需 API 密钥。e-Gov 法律搜索 API 无需密钥即可使用。

配置（Claude Code / 任意 MCP 客户端）

{
  "mcpServers": {
    "jp-eli-mcp": { "command": "jp-eli-mcp" }
  }
}

在启用了 Smart App Control 的 Windows 11 上使用

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

python -m pip install jp-eli-mcp
python -m jp_eli_mcp

出于同样的原因，pip.exe 也会被阻止，因此请使用 python -m pip 安装，而不是运行 pip install。如果 python 不在 PATH 中，请使用 Windows 启动器：py -3 -m jp_eli_mcp。

{ "mcpServers": { "jp-eli-mcp": { "command": "python", "args": ["-m", "jp_eli_mcp"] } } }

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

治理

• 仅限公共数据 - 以只读方式访问 e-Gov；不会有客户端数据离开本机。
• 审计日志 - 每次工具调用都会在 ~/.matematic/audit/jp-eli-mcp.jsonl 中追加一行 JSON。
• 供应商中立 - 仅与 laws.e-gov.go.jp 通信；不使用大模型提供商，也不进行遥测。
• 可验证的引用 - 每条响应都可通过 source_url 独立核验。

请参阅 CONSTITUTION.md 和 DISCOVERY.md。

测试

pip install -e ".[dev]"
pytest tests/test_instructions_drift.py -v   # offline
pytest tests/test_smoke.py -v                # hits live e-Gov

许可

Apache-2.0。© Matematic Solutions / Wieslaw Mazur。