uk-parliament-treaties

英国议会条约 MCP 服务

摘要

此 MCP 服务通过 Model Context Protocol 提供对英国议会条约数据的结构化访问。 它通过由 API 驱动的工具和数据访问功能，使 AI Agent 能够检索条约、议会事务项目和政府机构。 开发者可以通过 stdio 传输集成 MCP 服务，以查询条约元数据、系列归属和议会流程状态。 该服务提供与 Treaties API 直接对应的工具，支持可靠的自动化和 AI Agent 工作流。

功能

• 按议院、系列和议会流程状态筛选条约。
• 按 ID 检索条约和议会事务项目的详情。
• 访问政府机构和系列归属信息。
• 以标准化封装形式保留上游数据载荷，供下游工具使用。

可用工具

get_business_item_by_id

按 ID 返回议会事务项目。

参数：

• id（字符串，路径参数）

list_government_organisations

返回所有政府机构。

list_series_memberships

返回所有系列归属信息。

list_treaties

返回条约列表。

参数：

• SearchText（字符串，查询参数）
• GovernmentOrganisationId（数字，查询参数）
• Series（字符串，查询参数）– CountrySeriesMembership | EuropeanUnionSeriesMembership | MiscellaneousSeriesMembership
• ParliamentaryProcess（字符串，查询参数）– NotConcluded | Concluded
• DebateScheduled（布尔值，查询参数）
• MotionsTabledAboutATreaty（布尔值，查询参数）
• CommitteeRaisedConcerns（布尔值，查询参数）
• House（字符串，查询参数）– Commons | Lords
• Skip（数字，查询参数）
• Take（数字，查询参数）

get_treaty_by_id

按 ID 返回条约。

参数：

• id（字符串，路径参数）

list_business_items_by_treaty_id

返回属于指定 ID 条约的议会事务项目。

参数：

• id（字符串，路径参数）

输出示例

{
  "status": 200,
  "data": {
    "items": [
      {
        "treatyId": "CP123",
        "title": "Example Treaty",
        "house": "Commons"
      }
    ],
    "totalResults": 1
  },
  "upstream_path": "/api/Treaty",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

快速开始

使用 npx 运行 MCP 服务：

npx -y -p @darkhorseone/mcp-server-uk-parliament-treaties mcp-server-uk-parliament-treaties

MCP 配置

stdio 传输的 mcpServers 配置示例：

{
  "mcpServers": {
    "uk-parliament-treaties": {
      "command": "npx",
      "args": ["-y", "-p", "@darkhorseone/mcp-server-uk-parliament-treaties", "mcp-server-uk-parliament-treaties"],
      "env": {
        "UPSTREAM_BASE_URL": "https://treaties-api.parliament.uk",
        "REQUEST_TIMEOUT_MS": "10000"
      }
    }
  }
}

使用示例

• 按议院和议会流程状态搜索条约。
• 按 ID 获取条约并查看其元数据。
• 检索与条约相关的议会事务项目。
• 列出与条约相关的政府机构。

使用场景

• AI Agent 汇总条约状态和议会审查情况。
• 研究工具跟踪条约流程和时间安排。
• 公民科技平台按政府机构监控条约。
• 自动化工作流导出条约元数据以供分析。

数据来源

英国议会 Treaties API https://treaties-api.parliament.uk

安装

使用 npx 直接运行：

npx -y -p @darkhorseone/mcp-server-uk-parliament-treaties mcp-server-uk-parliament-treaties

或者在仓库根目录通过 pnpm 安装：

pnpm install

运行（HTTP 代理服务）

先构建，然后启动：

pnpm --filter @darkhorseone/mcp-server-uk-parliament-treaties run build
pnpm --filter @darkhorseone/mcp-server-uk-parliament-treaties run start:http

使用 UKP_HTTP_PORT 环境变量设置自定义 HTTP 端口（默认值：8787）：

UKP_HTTP_PORT=8787 pnpm --filter @darkhorseone/mcp-server-uk-parliament-treaties run start:http

已发布的软件包命令：

npx -y -p @darkhorseone/mcp-server-uk-parliament-treaties -- mcp-server-uk-parliament-treaties-http

如果 shell 无法解析 bin（“command not found”），请直接运行 HTTP 入口点：

npx -y -p @darkhorseone/mcp-server-uk-parliament-treaties -- node ./dist/http.js

健康检查：

curl http://127.0.0.1:8787/healthz

代理模式：

GET /proxy/<upstream-path>?<query>

示例：

curl "http://127.0.0.1:8787/proxy/api/Treaty?House=Commons&Take=10"

许可证

MIT 许可证

MCP 元数据

协议：Model Context Protocol 传输：stdio 工具：get_business_item_by_id, list_government_organisations, list_series_memberships, list_treaties, get_treaty_by_id, list_business_items_by_treaty_id