gb-eli-mcp

gb-eli-mcp

一个面向 legislation.gov.uk 的 MCP 服务。legislation.gov.uk 是英国国家档案馆的官方英国立法门户。它可搜索并检索议会法案、英国法定文书，以及苏格兰议会、威尔士议会（Senedd Cymru）和北爱尔兰议会的同类文书，并提供持久标识符和可核验的引文。

它属于 MateMatic 的 eu-legal-mcp 生产线：是波兰版 sejm-eli-mcp 和德国版 de-eli-mcp 的英国对应版本，采用相同的架构和引文契约，并以英国自身的来源为基础。

没有原生 ELI。 legislation.gov.uk 不提供原生的 /eli/ 命名空间（实时确认：GET /eli/ukpga/2018/12 返回 404），尽管其自身的持久标识符方案早于 ELI，且与 ELI 密切相关——英国被广泛认为率先提出了基于 URI 的立法标识符概念，之后 ELI 将其在欧盟范围内正式化。因此，eli_uri 使用英国自身的稳定 ID URI（https://www.legislation.gov.uk/id/{type}/{year}/{number}），而不是捏造一个 ELI 路径——这与本生产线的 nl-eli-mcp 和 se-eli-mcp 采用相同的披露方式。参见 CONSTITUTION.md 第 4 条。

许可证。 内容依据 Open Government Licence v3.0 发布（已从网站自身的 /help 页面实时确认），允许在注明出处的前提下复制、发布和改编。本连接器仅转发这些公开内容，每个响应都附带 source_url。

九种工具

工具	功能
gb_search	按文本、文书类型和年份搜索立法（/all/data.feed 或 /{doc_type}/data.feed）。
gb_get_act	按引用信息获取法案／文书元数据（例如 ukpga/2018/12）。
gb_get_text	获取全文（xml、html、akn/Akoma Ntoso、rdf、pdf、csv）。
gb_recent_legislation	获取指定日期以来发布的立法，按时间倒序排列，可按文书类型筛选。
gb_search_case_law	通过国家档案馆的 Find Case Law Atom feed，按文本、法院和日期范围搜索英国判决。
gb_get_case	按中性引文、Find Case Law URI／路径或不透明 ID 获取判决——返回 Akoma Ntoso XML；若不可用，则提供 PDF 链接作为备用。
gb_search_govuk	通过无需密钥的 Search API 搜索 GOV.UK 文档——包括就业／税务／房产法庭裁决、HMRC 内部手册和 CMA 案件——支持服务器端日期筛选并返回实际总数。
gb_get_govuk_content	通过 Content API 获取一份 GOV.UK 文档——法庭裁决会返回判决 PDF 链接，HMRC 手册章节会返回全文。
gb_coverage	说明此连接器覆盖的内容、各类别的采集时间，以及明确指出未覆盖的内容。每个缺口都提供替代方案。

GOV.UK 覆盖范围（v0.3.0 新增，feature-003）

一个上游来源，涵盖多个机构：gb_search_govuk 按 document_type 筛选。 经实时验证的总数（2026-07-07，来自 Search API 自身的 total／facet 字段—— 探测地址：https://www.gov.uk/api/search.json?count=0&facet_content_store_document_type=1000）：

document_type	文档数
employment_tribunal_decision	132,162
hmrc_manual_section	85,315
residential_property_tribunal_decision	17,088
employment_appeal_tribunal_decision	2,571
cma_case	2,565
utaac_decision（Upper Tribunal，AAC）	2,031
tax_tribunal_decision	1,414
asylum_support_decision	101

完整的逐来源清单见 SOURCES.md，其中包括调研过但有意排除的来源（ICO、FCA、IAC）及排除原因。

每个响应都包含以下契约字段：eli_uri （例如 https://www.legislation.gov.uk/id/ukpga/2018/12）、human_readable_citation （例如《Data Protection Act 2018》c. 12）和 source_url。判例响应遵循同一原则的契约（human_readable_citation、source_url、dataset_note）——参见 CONSTITUTION.md 第 5 条。

安装

作为 Claude 插件（Claude Code 或桌面应用，需要 uv）； 有关其发送和存储的内容，请参阅 plugin/README.md：

/plugin marketplace add matematicsolutions/gb-eli-mcp
/plugin install gb-eli-mcp@gb-eli-mcp

作为独立服务，通过 PyPI（uvx gb-eli-mcp）或从源代码安装：

cd gb-eli-mcp
pip install -e .

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

复制 .mcp.json.example，并在需要时进行调整：

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

使用 Smart App Control 的 Windows 11

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

python -m pip install gb-eli-mcp
python -m gb_eli_mcp

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

{ "mcpServers": { "gb-eli-mcp": { "command": "python", "args": ["-m", "gb_eli_mcp"] } } }

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

环境变量：

• GB_ELI_BASE_URL - 默认值为 https://www.legislation.gov.uk
• GB_ELI_CASELAW_BASE_URL - 默认值为 https://caselaw.nationalarchives.gov.uk
• GB_ELI_GOVUK_BASE_URL - 默认值为 https://www.gov.uk
• GB_ELI_CACHE_DIR - 默认值为 ~/.matematic/cache/gb-eli
• GB_ELI_AUDIT_DIR - 默认值为 ~/.matematic/audit

无需 API 密钥。legislation.gov.uk 无需密钥。

治理

• 仅限公共数据 - 以只读方式访问 legislation.gov.uk、Find Case Law 和 GOV.UK；除搜索参数外，不会有客户端数据离开本机。
• 审计日志 - 每次工具调用都会向 ~/.matematic/audit/gb-eli-mcp.jsonl 追加一行 JSON。
• 网络 - 服务会与 legislation.gov.uk、caselaw.nationalarchives.gov.uk、 www.gov.uk 以及本地文件系统通信。首次使用时，它还会从此仓库的 GitHub Releases 获取一个小型配置 文件（gb-runtime.json.gz，用于更新源地址）。 此请求不包含任何查询内容；我们能看到的唯一使用情况指标是 GitHub 对该文件的下载计数。设置 GB_ELI_RUNTIME_URL="" 可将其关闭；Claude 插件默认关闭此功能。无 LLM 提供商，也无其他遥测。
• 可验证的引用 - 每个响应都可通过 source_url 独立核验。

请参阅 CONSTITUTION.md（约束性规则）和 DISCOVERY.md（实时 API 探测）。

测试

pip install -e ".[dev]"
pytest tests/test_instructions_drift.py -v   # offline
pytest tests/test_citations_case_law.py -v   # offline
pytest tests/test_citations_govuk.py -v      # offline
pytest tests/test_smoke.py -v                # hits live legislation.gov.uk
pytest tests/test_smoke_case_law.py -v       # hits live caselaw.nationalarchives.gov.uk
pytest tests/test_smoke_govuk.py -v          # hits live www.gov.uk

许可证

Apache-2.0。（c）Matematic Solutions / Wieslaw Mazur。

注意：此仓库中的代码采用 Apache-2.0 许可证。运行时从 legislation.gov.uk 获取的立法内容仍受 Crown copyright 保护，并依据 Open Government Licence v3.0 发布——本项目不会重新授权这些内容。