uk-parliament-erskinemay

英国议会 Erskine May MCP 服务

概述

此 MCP 服务通过模型上下文协议，为用户提供对英国议会 Erskine May 内容的结构化访问。 它支持 AI Agent 通过由 API 提供支持的工具查询章节、部分、节和索引词条，从而可靠地访问数据。 开发者可以通过 stdio 传输方式连接 MCP 服务，获取权威的议事程序指南和参考资料。 该服务提供的工具与 Erskine May API 直接对应，可用于搜索和查找工作流。

功能

• 按标识符获取章节、部分、节和节概览。
• 按关键词浏览和搜索索引词条及段落。
• 支持结构化查找，并使用一致的响应封装。
• 保留上游 JSON 负载，供下游工具和 AI Agent 使用。

可用工具

get_chapter_by_chapter_number

按章节编号返回单个章节概览。

参数：

• chapterNumber（number，path）– 章节编号。

browse_index_terms

按首字母返回索引词条列表。

参数：

• startLetter（string，query）
• skip（number，query）
• take（number，query）

get_index_term_by_index_term_id

按 ID 返回索引词条。

参数：

• indexTermId（number，path）– 索引词条 ID。

list_parts

返回所有部分的列表。

get_part_by_part_number

按部分编号返回部分。

参数：

• partNumber（number，path）– 部分编号。

search_index_term_results_by_search_term

返回包含搜索词的索引词条列表。

参数：

• searchTerm（string，path）
• skip（number，query）
• take（number，query）

get_paragraph_by_reference

按引用返回节概览。

参数：

• reference（string，path）

search_paragraph_results_by_search_term

返回包含搜索词的段落列表。

参数：

• searchTerm（string，path）
• skip（number，query）
• take（number，query）

search_section_results_by_search_term

返回包含搜索词的节列表。

参数：

• searchTerm（string，path）
• skip（number，query）
• take（number，query）

get_section_by_section_id

按节 ID 返回节。

参数：

• sectionId（number，path）

get_section_overview_by_section_id_and_step

按节 ID 和步骤返回节概览。

参数：

• sectionId（number，path）
• step（number，path）

示例输出

{
  "status": 200,
  "data": {
    "sectionId": 12,
    "title": "Order in debate",
    "content": "..."
  },
  "upstream_path": "/api/Section/12",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

快速开始

使用 npx 运行 MCP 服务：

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

MCP 配置

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

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

使用示例

• 按章节编号获取章节。
• 按关键词搜索节，并对结果进行分页。
• 按 ID 和步骤获取节概览。
• 浏览以某个字母开头的索引词条。

使用场景

• AI Agent 使用权威参考资料回答议事程序问题。
• 法律或议会研究工具映射节和段落。
• 公民科技工作流利用 Erskine May 参考资料丰富数据集。
• 自动化系统为检索建立议事程序内容索引。

数据来源

英国议会 Erskine May API https://erskinemay-api.parliament.uk

安装

使用 npx 直接运行：

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

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

pnpm install

运行（HTTP 代理服务）

先构建，然后启动：

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

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

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

已发布的软件包命令：

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

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

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

健康检查：

curl http://127.0.0.1:3000/healthz

代理模式：

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

示例：

curl "http://127.0.0.1:3000/proxy/api/Part"

许可证

MIT 许可证

MCP 元数据

协议：Model Context Protocol 传输方式：stdio 工具：get_chapter_by_chapter_number、browse_index_terms、get_index_term_by_index_term_id、list_parts、get_part_by_part_number、search_index_term_results_by_search_term、get_paragraph_by_reference、search_paragraph_results_by_search_term、search_section_results_by_search_term、get_section_by_section_id、get_section_overview_by_section_id_and_step