uk-parliament-statutoryinstruments

英国议会法定文书 MCP 服务

概要

此 MCP 服务使用 Model Context Protocol，提供对英国议会法定文书数据的结构化访问。 它支持 AI Agent 通过 API 驱动的工具和数据访问，查询法定文书、程序、提交机构和议会事务。 开发者可以通过 stdio 传输集成此 MCP 服务，从 v1 和 v2 端点获取法定文书。 该服务提供直接映射到法定文书 API 的工具，以支持可靠的自动化和 AI Agent 工作流。

功能

• 搜索法定文书和拟议否定文书，并按院、程序和状态筛选。
• 按 ID 获取文书详情、程序和议会事务。
• 通过 v1 和 v2 端点访问提交机构和议会法案。
• 将上游负载保存在标准化封装中，供下游工具使用。

可用工具

get_v1_business_item_by_id

按 ID 返回议会事务。

参数：

• id（string，path）
• LaidPaper（string，query）– StatutoryInstrument | ProposedNegative

list_v1_laying_bodies

返回所有提交机构。

list_v1_procedures

返回所有程序。

get_v1_procedure_by_id

按 ID 返回程序。

参数：

• id（string，path）

list_v1_proposed_negative_statutory_instruments

返回拟议否定法定文书列表。

参数：

• Name（string，query）
• RecommendedForProcedureChange（boolean，query）
• DepartmentId（number，query）
• LayingBodyId（string，query）
• Skip（number，query）
• Take（number，query）

get_v1_proposed_negative_statutory_instrument_by_id

按 ID 返回拟议否定法定文书。

参数：

• id（string，path）

list_v1_business_items_by_proposed_negative_statutory_instrument_id

返回属于拟议否定法定文书的议会事务。

参数：

• id（string，path）

list_v1_statutory_instruments

返回法定文书列表。

参数：

• Name（string，query）
• StatutoryInstrumentType（string，query）– DraftAffirmative | DraftNegative | MadeAffirmative | MadeNegative
• ScheduledDebate（boolean，query）
• MotionToStop（boolean，query）
• ConcernsRaisedByCommittee（boolean，query）
• ParliamentaryProcessConcluded（string，query）– NotConcluded | Concluded
• DepartmentId（number，query）
• LayingBodyId（string，query）
• House（string，query）– Commons | Lords
• Skip（number，query）
• Take（number，query）

get_v1_statutory_instrument_by_id

按 ID 返回法定文书。

参数：

• id（string，path）

list_v1_business_items_by_statutory_instrument_id

返回属于指定 ID 法定文书的议会事务。

参数：

• id（string，path）

list_v2_acts_of_parliament

搜索议会法案。

参数：

• Id（array:string，query）
• Name（string，query）

get_v2_act_of_parliament_by_id

按 ID 搜索单部议会法案。

参数：

• id（string，path）

list_v2_statutory_instruments

搜索法定文书和拟议否定文书。

参数：

• Name（string，query）
• Procedure（string，query）
• ScheduledDebate（boolean，query）
• MotionToStop（boolean，query）
• ConcernsRaisedByCommittee（boolean，query）
• ParliamentaryProcessConcluded（boolean，query）
• DepartmentId（number，query）
• LayingBodyId（string，query）
• RecommendedForProcedureChange（boolean，query）
• ActOfParliamentId（array:string，query）
• House（string，query）– Commons | Lords
• Skip（number，query）
• Take（number，query）

get_v2_statutory_instrument_by_instrument_id

按 ID 获取单部法定文书或拟议否定文书。

参数：

• instrumentId（string，path）

list_v2_business_items_by_instrument_id

获取与指定文书相关的议会事务。

参数：

• instrumentId（string，path）

list_v2_business_items_by_timeline_id

获取与特定时间线关联的业务事项。

参数：

• timelineId（string，路径参数）

示例输出

{
  "status": 200,
  "data": {
    "items": [
      {
        "instrumentId": "abcd1234",
        "name": "Example Statutory Instrument",
        "house": "Commons"
      }
    ],
    "totalResults": 1
  },
  "upstream_path": "/api/v2/StatutoryInstrument",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

快速开始

使用 npx 运行 MCP 服务：

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

MCP 配置

stdio 传输方式的 mcpServers 配置示例：

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

使用示例

• 按名称筛选，列出提交至下议院的法定文书。
• 按 ID 获取法定文书并查看其程序。
• 获取法定文书或时间线的业务事项。
• 搜索与法定文书相关的议会法案。

使用场景

• AI Agent 总结法定文书的状态和程序。
• 研究工具按部门或议院跟踪文书。
• 公民科技平台监控拟议否决和辩论。
• 自动化工作流导出文书元数据以供报告使用。

数据源

英国议会法定文书 API https://statutoryinstruments-api.parliament.uk

安装

使用 npx 直接运行：

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

或者在仓库根目录使用 pnpm 安装：

pnpm install

运行（HTTP 代理服务）

先构建，再启动：

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

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

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

已发布软件包的命令：

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

如果 shell 无法解析二进制文件（显示“command not found”），请直接运行 HTTP 入口点：

npx -y -p @darkhorseone/mcp-server-uk-parliament-statutoryinstruments -- 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/v2/StatutoryInstrument?House=Commons&Take=10"

许可证

MIT 许可证

MCP 元数据

协议：Model Context Protocol 传输方式：stdio 工具：get_v1_business_item_by_id, list_v1_laying_bodies, list_v1_procedures, get_v1_procedure_by_id, list_v1_proposed_negative_statutory_instruments, get_v1_proposed_negative_statutory_instrument_by_id, list_v1_business_items_by_proposed_negative_statutory_instrument_id, list_v1_statutory_instruments, get_v1_statutory_instrument_by_id, list_v1_business_items_by_statutory_instrument_id, list_v2_acts_of_parliament, get_v2_act_of_parliament_by_id, list_v2_statutory_instruments, get_v2_statutory_instrument_by_instrument_id, list_v2_business_items_by_instrument_id, list_v2_business_items_by_timeline_id