uk-parliament-interests

英国议会利益登记册 MCP 服务

概要

此 MCP 服务使用 Model Context Protocol 提供对英国议会利益登记册的结构化访问。 它支持 AI Agent 通过基于 API 的工具和数据访问，查询利益类别、已发布的登记册和利益记录。 开发者可通过 stdio 传输集成 MCP 服务，以便在分析工作流中获取登记册、利益信息和 PDF。 此服务提供的工具与利益登记册 API 一一对应，并针对 AI Agent 和开发者工具进行了优化。

功能

• 列出利益类别，并按 ID 获取类别详情。
• 获取已发布的登记册、登记册 PDF 和登记册元数据。
• 按议员、日期和类别筛选并查询利益信息。
• 将上游负载保存在标准化封装中，供下游工具和 AI Agent 使用。

可用工具

ukpi_categories_list

返回应登记利益的类别列表，并按类别编号排序。

参数：

• Skip（number，query）– 要跳过的记录数。
• Take（number，query）– 要返回的记录数。

ukpi_categories_get_by_id

按 ID 返回利益类别详情。

参数：

• id（number，path）– 类别 ID。

ukpi_interests_list

返回已在登记册上发布的利益列表。

参数：

• MemberId（number，query）
• CategoryId（number，query）
• PublishedFrom（string，query）
• PublishedTo（string，query）
• RegisteredFrom（string，query）
• RegisteredTo（string，query）
• UpdatedFrom（string，query）
• UpdatedTo（string，query）
• RegisterId（number，query）
• ExpandChildInterests（boolean，query）
• Take（number，query）
• SortOrder（string，query）– PublishingDateDescending | CategoryAscending
• Skip（number，query）

ukpi_interests_csv

以 ZIP 文件打包的 CSV 格式返回利益信息。

参数：

• MemberId（number，query）
• CategoryId（number，query）
• PublishedFrom（string，query）
• PublishedTo（string，query）
• RegisteredFrom（string，query）
• RegisteredTo（string，query）
• UpdatedFrom（string，query）
• UpdatedTo（string，query）
• RegisterId（number，query）
• IncludeFieldDescriptions（boolean，query）

ukpi_interests_get_by_id

返回已发布利益信息的最新版本。

参数：

• id（number，path）– 利益 ID。

ukpi_registers_list

返回已发布的利益登记册版本列表。

参数：

• SessionId（number，query）
• Skip（number，query）
• Take（number，query）

ukpi_registers_get_by_id

按 ID 返回已发布的利益登记册版本。

参数：

• id（number，path）– 登记册 ID。

ukpi_registers_document

按 ID 将已发布的登记册作为 PDF 文档返回。

参数：

• id（number，path）– 登记册 ID。
• type（string，query）– Full | Updated

输出示例

{
  "status": 200,
  "data": {
    "items": [
      {
        "interestId": 9876,
        "memberId": 123,
        "categoryId": 2,
        "publishedDate": "2026-03-01"
      }
    ],
    "totalResults": 1
  },
  "upstream_path": "/api/v1/Interests",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

快速开始

使用 npx 运行 MCP 服务：

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

MCP 配置

stdio 传输的 mcpServers 配置示例：

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

使用示例

• 列出某位议员已发布的利益信息。
• 获取特定利益信息（按 ID）。
• 获取某个议会会期的登记册。
• 下载最新的登记册 PDF。

使用场景

• AI Agent 总结议员利益信息，用于透明度报告。
• 合规工作流跟踪已发布登记册的更新。
• 研究工具按类别或日期汇总利益信息。
• 公民科技平台监测登记册数据变化。

数据来源

英国议会利益登记册 API https://interests-api.parliament.uk/

安装

使用 npx 直接运行：

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

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

pnpm install

运行（HTTP 代理服务）

先构建，再启动：

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

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

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

已发布的软件包命令：

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

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

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

健康检查：

curl http://127.0.0.1:8787/healthz

许可证

MIT 许可证

MCP 元数据

协议：Model Context Protocol 传输方式：stdio 工具：ukpi_categories_list, ukpi_categories_get_by_id, ukpi_interests_list, ukpi_interests_csv, ukpi_interests_get_by_id, ukpi_registers_list, ukpi_registers_get_by_id, ukpi_registers_document