Uk Parliament Treaties

io.github.nick-ma由 GitHub 帳號 nick-ma 發布v1.0.1更新於 Oct 24, 2026

MCP server for UK Parliament Treaties API

已驗證STDIO僅桌面知識與記憶資料與分析

概覽

AI 產生的概覽

讓助理查詢英國議會條約資料，包括條約、業務事項、政府機關與系列成員資訊。

可以做什麼
將英國議會條約 API 包裝成唯讀工具：list_treaties 可依院別、系列、議會程序狀態、辯論安排、動議與委員會關切等條件檢索；get_treaty_by_id 與 get_business_item_by_id 依 ID 取得單筆紀錄；list_business_items_by_treaty_id 回傳與某條約相關的事項；list_government_organisations 與 list_series_memberships 回傳參考清單。回傳結果以統一信封保留上游原始資料，並附上游路徑與擷取時間。
適用情境
適合追蹤英國條約審議、議會程序狀態或相關政府機關的研究、公民科技與報告類工作。它是唯讀的公開資料來源，適合用於彙整或監測條約動態，而非執行操作。
執行需求
透過 stdio 在本機執行，通常以 npx 呼叫 npm 套件 @darkhorseone/mcp-server-uk-parliament-treaties，因此需要 Node.js 以及連線條約 API 的網路。選用環境變數包括 UPSTREAM_BASE_URL 與 REQUEST_TIMEOUT_MS；HTTP 代理模式使用 UKP_HTTP_PORT。未宣告需要帳號或 API 金鑰。
安裝前請注意
所有工具都是對公開 API 的唯讀查詢，不會寫入、傳送或刪除資料。請求會送往外部英國議會條約 API，查詢內容會離開本機。回傳的條約中介資料應視為公開參考資料，而非權威法律意見。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Uk Parliament Treaties，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[MCP Compatible] [AI Agent Ready]

UK Parliament Treaties MCP Server

Summary

This MCP server provides structured access to UK Parliament Treaties data using the Model Context Protocol. It enables AI agents to retrieve treaties, business items, and government organisations through API-backed tools and data access. Developers can integrate the MCP server via stdio transport to query treaty metadata, series memberships, and parliamentary process status. The server exposes tools that map directly to the Treaties API for reliable automation and AI agents workflows.

Features

  • Search treaties with filters for house, series, and parliamentary process status.
  • Retrieve treaty and business item details by ID.
  • Access government organisations and series memberships.
  • Preserve upstream payloads in a standardized envelope for downstream tools.

Available Tools

get_business_item_by_id

Returns business item by ID.

Parameters:

  • id (string, path)

list_government_organisations

Returns all government organisations.

list_series_memberships

Returns all series memberships.

list_treaties

Returns a list of treaties.

Parameters:

  • SearchText (string, query)
  • GovernmentOrganisationId (number, query)
  • Series (string, query) – CountrySeriesMembership | EuropeanUnionSeriesMembership | MiscellaneousSeriesMembership
  • ParliamentaryProcess (string, query) – NotConcluded | Concluded
  • DebateScheduled (boolean, query)
  • MotionsTabledAboutATreaty (boolean, query)
  • CommitteeRaisedConcerns (boolean, query)
  • House (string, query) – Commons | Lords
  • Skip (number, query)
  • Take (number, query)

get_treaty_by_id

Returns a treaty by ID.

Parameters:

  • id (string, path)

list_business_items_by_treaty_id

Returns business items belonging to the treaty with ID.

Parameters:

  • id (string, path)

Example Output

json
{  "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"}

Quick Start

Run the MCP server using npx:

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

MCP Configuration

Example mcpServers configuration for stdio transport:

json
{  "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"      }    }  }}

Example Usage

  • Search treaties by house and parliamentary process status.
  • Fetch a treaty by ID and review its metadata.
  • Retrieve business items linked to a treaty.
  • List government organisations associated with treaties.

Use Cases

  • AI agents summarizing treaty status and parliamentary scrutiny.
  • Research tools tracking treaty processes and schedules.
  • Civic tech platforms monitoring treaties by government body.
  • Automation workflows exporting treaty metadata for analysis.

Data Source

UK Parliament Treaties API https://treaties-api.parliament.uk

Installation

Run directly using npx:

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

Or install via pnpm from the repository root:

bash
pnpm install

Run (HTTP proxy server)

Build first, then start:

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

Set a custom HTTP port with the UKP_HTTP_PORT environment variable (default: 8787):

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

Published package command:

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

If your shell cannot resolve the bin ("command not found"), run the HTTP entrypoint directly:

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

Health check:

bash
curl http://127.0.0.1:8787/healthz

Proxy pattern:

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

Example:

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

License

MIT License

MCP Metadata

Protocol: Model Context Protocol Transport: stdio Tools: get_business_item_by_id, list_government_organisations, list_series_memberships, list_treaties, get_treaty_by_id, list_business_items_by_treaty_id

來源：servers/uk-parliament-treaties/README.md，提交 38e74c9

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。