uk-parliament-treaties

英国議会条約 MCP サーバー

概要

この MCP サーバーは、Model Context Protocol を使用して英国議会の条約データに構造化された形でアクセスできるようにします。 API を利用したツールとデータアクセスを通じて、AI エージェントが条約、案件、政府機関を取得できます。 開発者は stdio トランスポート経由で MCP サーバーを統合し、条約のメタデータ、シリーズへの所属、議会手続きの状況を照会できます。 このサーバーは Treaties API に直接対応するツールを提供し、信頼性の高い自動化と AI エージェントのワークフローを実現します。

機能

• 議院、シリーズ、議会手続きの状況で絞り込んで条約を検索します。
• ID を指定して条約と案件の詳細を取得します。
• 政府機関とシリーズへの所属情報にアクセスします。
• 下流ツール向けに、標準化されたエンベロープ内で上流のペイロードを保持します。

利用可能なツール

get_business_item_by_id

ID を指定して案件を返します。

パラメーター：

• id（string、path）

list_government_organisations

すべての政府機関を返します。

list_series_memberships

すべてのシリーズへの所属情報を返します。

list_treaties

条約の一覧を返します。

パラメーター：

• 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

ID を指定して条約を返します。

パラメーター：

• id（string、path）

list_business_items_by_treaty_id

ID を指定した条約に属する案件を返します。

パラメーター：

• id（string、path）

出力例

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

クイックスタート

npx を使って MCP サーバーを実行します：

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

MCP の設定

stdio トランスポート向けの mcpServers 設定例：

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

使用例

• 議院と議会手続きの状況で条約を検索します。
• ID を指定して条約を取得し、メタデータを確認します。
• 条約に関連付けられた案件を取得します。
• 条約に関連する政府機関を一覧表示します。

ユースケース

• 条約の状況と議会による精査を要約する AI エージェント。
• 条約の手続きと日程を追跡する調査ツール。
• 政府機関ごとに条約を監視するシビックテックプラットフォーム。
• 分析用に条約のメタデータをエクスポートする自動化ワークフロー。

データソース

英国議会 Treaties API https://treaties-api.parliament.uk

インストール

npx を使って直接実行します：

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

または、リポジトリのルートから pnpm でインストールします：

pnpm install

実行（HTTP プロキシサーバー）

先にビルドしてから起動します：

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

UKP_HTTP_PORT 環境変数を使って HTTP ポートをカスタマイズします（デフォルト：8787）：

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

公開パッケージのコマンド：

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

シェルでバイナリを解決できない場合（「command not found」）、HTTP エントリーポイントを直接実行します：

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

ライセンス

MIT License

MCP メタデータ

プロトコル：Model Context Protocol トランスポート：stdio ツール：get_business_item_by_id, list_government_organisations, list_series_memberships, list_treaties, get_treaty_by_id, list_business_items_by_treaty_id