Jp Eli Mcp

io.github.matematicsolutions由 GitHub 账号 matematicsolutions 发布v0.3.3更新于 Oct 24, 2026

MCP server for Japan's e-Gov law search API: search, fetch, and cite national legislation.

概览

AI 生成的概览

面向日本官方 e-Gov 法令检索 API 的只读 MCP 服务器,让助手检索、获取并引用日本国家法律法规。

可以做什么
  • 按法律标题片段或全文关键词检索法律,并返回高亮片段
  • 获取法律元数据:标题、法令编号、公布日期
  • 按法律 ID 与条文号获取单条条文,或获取法律全文(超长法律会被截断)
  • 说明覆盖范围:包含哪些法律类别、采集时间,以及明确未覆盖的内容
  • 为每次响应附带引用信息:稳定的 e-Gov 浏览链接、可读引用文本与来源 URL
适用场景
适合助手需要查阅日本法律、政令或省令并给出可核验引用的场景,例如法律研究、合规核查,或依赖现行日本法律的文书起草。
运行要求
以本地 Python 包(jp-eli-mcp)运行,通常通过 uvx 或 python -m jp_eli_mcp 启动;README 说明在正式发布前可能需要从源码安装。无需 API 密钥。可选环境变量可设置 API 基础地址、缓存目录与审计目录。需要能访问 e-Gov 法令 API 的网络。
安装前请注意
对 e-Gov 公开数据为只读操作,但每次工具调用都会追加写入本地审计日志文件。可选环境变量可改写 API 基础地址,并改变缓存与审计文件的写入位置。超长法律的全文会被截断,长篇法规可能不完整;请用返回的来源 URL 核对引用。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Jp Eli Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

jp-eli-mcp

An MCP server for Japan's official e-Gov law search API (laws.e-gov.go.jp), run by the Digital Agency. It searches, fetches, and cites national legislation - acts, cabinet orders, ministerial ordinances - with a verifiable citation on every response.

Part of the MateMatic eu-legal-mcp production line, extended into Asia. Same citation contract (a stable identifier + a human-readable citation + a source URL) as the 18 EU/EEA connectors, adapted for a jurisdiction with no ELI scheme.

Scope. Discovery is by law title (jp_search_laws) or full-text keyword (jp_search_by_keyword); fetch a specific article (jp_get_article) or the full text (jp_get_full_text, truncated for very large laws such as the Civil Code). Every response carries a dataset_note.

Licence. e-Gov law data is official public information published by the Japanese government as open data (keyless, REST/JSON). This connector relays it with attribution and a source_url.

The tools

ToolWhat it does
jp_search_lawsSearch laws by (partial) title.
jp_search_by_keywordFull-text search across all laws, with highlighted snippets.
jp_get_lawMetadata for a law by law_id: title, law number, promulgation date.
jp_get_articleThe text of one article of a law, by law_id and article_num.
jp_get_full_textThe full text of a law (truncated at ~300,000 characters).
jp_coverageDeclare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback.

Every response carries the contract: eli_uri (Japan has no ELI - this is the durable e-Gov viewer URL, e.g. https://laws.e-gov.go.jp/law/129AC0000000089, see eli_note), human_readable_citation (e.g. 民法(明治二十九年法律第八十九号)), and source_url (the machine-readable API URL).

Install

Not yet on PyPI - install from source until the first release ships:

bash
git clone https://github.com/matematicsolutions/jp-eli-mcpcd jp-eli-mcppip install -e .

Once released, this will be uvx jp-eli-mcp.

Configuration via env:

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

No API key. e-Gov's law search API is keyless.

Configure (Claude Code / any MCP client)

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

Windows 11 with Smart App Control

Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe and the jp-eli-mcp.exe launcher that pip writes at install time. The python.exe and py.exe from the python.org installer are signed by the Python Software Foundation, so running the module through the interpreter works:

bash
python -m pip install jp-eli-mcppython -m jp_eli_mcp

pip.exe is blocked for the same reason, so install with python -m pip, not pip install. If python is not on PATH, use the Windows launcher: py -3 -m jp_eli_mcp.

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

Do not turn Smart App Control off to work around this - it cannot be re-enabled without reinstalling Windows.

Governance

  • Public data only - read-only against e-Gov; no client data leaves the machine.
  • Audit log - every tool call appends one JSON line to ~/.matematic/audit/jp-eli-mcp.jsonl.
  • Vendor-neutral - talks only to laws.e-gov.go.jp; no LLM provider, no telemetry.
  • Verifiable citations - every response is independently checkable via source_url.

See CONSTITUTION.md and DISCOVERY.md.

Tests

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

Licence

Apache-2.0. © Matematic Solutions / Wieslaw Mazur.

来源:README.md,提交 d5769b2

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.3.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分