uk-parliament-committees

英国议会委员会 MCP 服务

概要

此 MCP 服务使用 Model Context Protocol 提供对英国议会委员会数据的结构化访问。 它支持 AI Agent 通过由 API 支持的工具和数据访问来查询委员会、委员会事务、活动、出版物、证据和请愿。 开发者可以通过 stdio 传输连接 MCP 服务，为需要权威委员会信息的自动化流程和 AI Agent 提供可靠支持。 该服务提供直接映射到 Committees API 的工具，支持搜索、查询和文档检索工作流。

功能

• 使用结构化筛选条件检索委员会、委员会类型和委员会事务。
• 使用日期和状态参数访问会议、活动、事务及出席数据。
• 获取出版物、证据、请愿及相关文档，并获得一致的响应。
• 将上游负载保存在标准化封装中，供下游工具和 AI Agent 使用。

可用工具

get_bill_petitions

返回账单请愿列表。

参数：

• CommitteeBusinessId (number, query) – 委员会事务 ID 筛选条件。
• CommitteeId (number, query) – 委员会 ID 筛选条件。
• SearchTerm (string, query) – 按证人／组织／标识符搜索。
• StartDate (string, query) – 发布日期不早于此日期。
• EndDate (string, query) – 发布日期不晚于此日期。
• ShowOnWebsiteOnly (boolean, query) – 仅返回网站上的结果。
• Skip (number, query) – 偏移量。
• Take (number, query) – 数量上限。

get_bill_petition_by_id

返回一项账单请愿。

参数：

• id (number, path) – 账单请愿 ID。
• showOnWebsiteOnly (boolean, query) – 仅返回网站上的结果。

get_bill_petition_document

返回账单请愿的文档。

参数：

• id (number, path) – 请愿 ID。
• fileDataFormat (string, path) – OriginalFormat | Html | Pdf。

get

获取两个日期之间的委员会会议列表。

参数：

• FromDate (string, query) – 起始日期（yyyy-mm-dd）。
• ToDate (string, query) – 结束日期（yyyy-mm-dd）。

get_committee_business

返回委员会事务列表。

参数：

• SearchTerm (string, query)
• CommitteeId (number, query)
• DateFrom (string, query)
• DateTo (string, query)
• BusinessTypeId (number, query)
• Status (string, query) – Open | Closed
• CurrentlyAcceptingPetitions (boolean, query)
• CurrentlyAcceptingEvidence (boolean, query)
• SortOrder (string, query) – DateOpenedNewest | DateOpenedOldest | PublicationDateAscending | PublicationDateDescending
• CommitteeBusinessIds (array:number, query)
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

get_committee_business_by_id

返回一项委员会事务。

参数：

• id (number, path) – 委员会事务 ID。
• includeBanners (boolean, query)
• showOnWebsiteOnly (boolean, query)

list_committee_business_publication_groups

返回委员会事务的出版物组列表。

参数：

• id (number, path) – 委员会事务 ID。

list_committee_business_types

返回委员会事务类型列表。

list_committee_types

返回委员会类型列表。

get_committees

返回委员会列表。

参数：

• CommitteeBusinessId (number, query)
• SearchTerm (string, query)
• ParentCommitteeId (number, query)
• CommitteeStatus (string, query) – Current | Former | All
• CommitteeTypeId (number, query)
• CommitteeCategory (string, query) – Select | General | Other
• House (string, query) – Commons | Lords | Joint
• CommitteeIds (array:number, query)
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

get_next_event_for_committees

返回符合指定条件的委员会下一场活动列表。

参数：

• EventWithActivitiesOnly (boolean, query)
• EventFromDate (string, query)
• House (string, query) – Commons | Lords | Joint
• EventTypes (array:number, query)
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

get_committee_by_id

返回一个委员会。

参数：

• id (number, path) – 委员会 ID。
• includeBanners (boolean, query)
• showOnWebsiteOnly (boolean, query)

get_events_committee_by_id

返回与所提供委员会 ID 相关的活动。

参数：

• id (number, path) – 委员会 ID。
• CommitteeBusinessId (number, query)
• SearchTerm (string, query)
• StartDateFrom (string, query)
• StartDateTo (string, query)
• EndDateFrom (string, query)
• House (string, query) – Commons | Lords | Joint
• LocationId (number, query)
• ExcludeCancelledEvents (boolean, query)
• SortAscending (boolean, query)
• EventTypeId (number, query)
• IncludeEventAttendees (boolean, query)
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

list_committee_memberships

返回委员会成员资格列表。

参数：

• id (number, path) – 委员会 ID。
• MembershipStatus (string, query) – Current | Former | All
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

get_committee_person_photo

返回委员会非专业成员的照片。

参数：

• id (number, path) – 委员会 ID。
• personId (number, path) – 人员 ID。

list_committee_staff_memberships

返回委员会工作人员列表。

参数：

• id (number, path) – 委员会 ID。
• MembershipStatus (string, query) – Current | Former | All
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

list_committee_publication_groups

返回委员会出版物组列表。

参数：

• id (number, path) – 委员会 ID。

get_committee_archived_publication_links

返回与委员会关联的所有委员会已归档出版物链接。

参数：

• id (number, path) – 委员会 ID。

get_countries

返回国家列表。

get_events

返回活动列表。

参数：

• CommitteeId (number, query)
• CommitteeBusinessId (number, query)
• GroupChildEventsWithParent (boolean, query)
• SearchTerm (string, query)
• StartDateFrom (string, query)
• StartDateTo (string, query)
• EndDateFrom (string, query)
• House (string, query) – Commons | Lords | Joint
• LocationId (number, query)
• ExcludeCancelledEvents (boolean, query)
• SortAscending (boolean, query)
• EventTypeId (number, query)
• IncludeEventAttendees (boolean, query)
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

get_event_activities

返回活动项目列表。

参数：

• IncludeActivityAttendees (boolean, query)
• CommitteeId (number, query)
• CommitteeBusinessId (number, query)
• GroupChildEventsWithParent (boolean, query)
• SearchTerm (string, query)
• StartDateFrom (string, query)
• StartDateTo (string, query)
• EndDateFrom (string, query)
• House (string, query) – Commons | Lords | Joint
• LocationId (number, query)
• ExcludeCancelledEvents (boolean, query)
• SortAscending (boolean, query)
• EventTypeId (number, query)
• IncludeEventAttendees (boolean, query)
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

get_event_by_id

返回一场活动。

参数：

• id (number, path) – 活动 ID。
• showOnWebsiteOnly (boolean, query)

get_attendances_by_id

返回活动出席记录列表。

参数：

• id (number, path) – 活动 ID。
• showOnWebsiteOnly (boolean, query)

get_activities_by_id

返回活动项目列表。

参数：

• id (number, path) – 活动 ID。
• showOnWebsiteOnly (boolean, query)

list_members_committee_memberships

返回一个或多个成员的成员资格列表。

参数：

• Members (array:number, query) – 成员 ID。
• MembershipStatus (string, query) – 当前 | 曾任 | 全部
• CommitteeCategory (string, query) – 选择 | 综合 | 其他
• ShowOnWebsiteOnly (boolean, query)

banners

返回消息横幅。

参数：

• location (string, path) – 横幅位置。

get_oral_evidence

返回口头证据列表。

参数：

• CommitteeBusinessId (number, query)
• CommitteeId (number, query)
• SearchTerm (string, query)
• StartDate (string, query)
• EndDate (string, query)
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

get_oral_evidence_by_id

返回一项口头证据。

参数：

• id (number, path) – 口头证据 ID。
• showOnWebsiteOnly (boolean, query)

get_oral_evidence_document

返回口头证据的文档。

参数：

• id (number, path) – 口头证据 ID。
• fileDataFormat (string, path) – OriginalFormat | Html | Pdf。

list_publication_types

返回出版物类型列表。

get_publications

返回出版物列表。

参数：

• PublicationTypeIds (array:number, query)
• SearchTerm (string, query)
• StartDate (string, query)
• EndDate (string, query)
• SortOrder (string, query) – PublicationDateDescending | PublicationDateAscending | ResponseDateDescending | ResponseDateAscending
• PaperNumbers (array:string, query)
• CommitteeBusinessId (number, query)
• CommitteeId (number, query)
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

get_publication_by_id

返回一份出版物。

参数：

• id (number, path) – 出版物 ID。
• showOnWebsiteOnly (boolean, query)

get_document

返回出版物的文档。

参数：

• id (number, path) – 出版物 ID。
• documentId (number, path) – 文档 ID。
• fileDataFormat (string, path) – OriginalFormat | Html | Pdf。

get_submission_period_template_document_by_id

返回一份提交期限模板文件。

参数：

• id (number, path) – 提交期限模板 ID。
• documentId (number, path) – 文档 ID。

get_submission_period_by_id

返回一个提交期限。

参数：

• id (number, path) – 提交期限 ID。

get_written_evidence

返回书面证据列表。

参数：

• CommitteeBusinessId (number, query)
• CommitteeId (number, query)
• SearchTerm (string, query)
• StartDate (string, query)
• EndDate (string, query)
• ShowOnWebsiteOnly (boolean, query)
• Skip (number, query)
• Take (number, query)

get_written_evidence_by_id

返回一项书面证据。

参数：

• id (number, path) – 书面证据 ID。
• showOnWebsiteOnly (boolean, query)

get_written_evidence_document

返回书面证据的文档。

参数：

• id (number, path) – 书面证据 ID。
• fileDataFormat (string, path) – OriginalFormat | Html | Pdf。

示例输出

{
  "status": 200,
  "data": {
    "items": [
      {
        "committeeId": 123,
        "name": "Select Committee on Energy",
        "house": "Commons",
        "status": "Current"
      }
    ],
    "totalResults": 1
  },
  "upstream_path": "/api/Committees",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

快速开始

使用 npx 运行 MCP 服务：

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

MCP 配置

stdio 传输的 mcpServers 配置示例：

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

使用示例

• 列出下议院的现任委员会。
• 按关键词查找委员会事务，并按状态筛选。
• 获取指定日期范围内某个委员会的活动。
• 下载委员会出版物文档的 PDF。

使用场景

• 总结委员会活动和即将举行的会议的 AI Agent。
• 跟踪证据提交和出版物的研究工具。
• 监控委员会事务状态的公民科技平台。
• 使用委员会元数据丰富数据集的自动化系统。

数据来源

英国议会委员会 API https://committees-api.parliament.uk/index.html

安装

使用 npx 直接运行：

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

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

pnpm install

运行（HTTP 代理服务器）

先构建，然后启动：

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

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

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

已发布包的命令：

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

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

npx -y -p @darkhorseone/mcp-server-uk-parliament-committees -- 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/Committees?Take=5"

许可证

MIT 许可证

MCP 元数据

协议：Model Context Protocol 传输方式：stdio 工具：get_bill_petitions, get_bill_petition_by_id, get_bill_petition_document, get, get_committee_business, get_committee_business_by_id, list_committee_business_publication_groups, list_committee_business_types, list_committee_types, get_committees, get_next_event_for_committees, get_committee_by_id, get_events_committee_by_id, list_committee_memberships, get_committee_person_photo, list_committee_staff_memberships, list_committee_publication_groups, get_committee_archived_publication_links, get_countries, get_events, get_event_activities, get_event_by_id, get_attendances_by_id, get_activities_by_id, list_members_committee_memberships, banners, get_oral_evidence, get_oral_evidence_by_id, get_oral_evidence_document, list_publication_types, get_publications, get_publication_by_id, get_document, get_submission_period_template_document_by_id, get_submission_period_by_id, get_written_evidence, get_written_evidence_by_id, get_written_evidence_document