uk-parliament-commonsvotes

英国議会庶民院採決 MCP サーバー

概要

この MCP サーバーは、Model Context Protocol を使用して、英国議会庶民院採決データに構造化されたアクセスを提供します。 API を利用したツールを通じて、AI エージェントが採決と投票記録を取得できるようにし、自動化と分析のために信頼性の高いデータアクセスを実現します。 開発者は stdio トランスポート経由で MCP サーバーを統合し、採決の詳細、議員の投票履歴、検索結果にアクセスできます。 このサーバーは庶民院採決 API に直接対応するツールを公開し、AI エージェントや開発者ツールによる高速で一貫性のあるクエリを可能にします。

機能

• 採決 ID を指定して、庶民院の採決詳細を JSON または XML で取得します。
• 議員、日付、採決番号で絞り込んで採決を検索します。
• 議員の投票記録と、政党別にグループ化した概要を取得します。
• 下流のツールや AI エージェント向けに、一貫したエンベロープで上流のレスポンスを保持します。

利用可能なツール

ukpcv_division_get_by_id

採決を返します。

パラメーター：

• divisionId (number, path) – 採決 ID。
• format (string, path) – xml または json。

ukpcv_divisions_grouped_by_party

政党別にグループ化した採決結果を返します。

パラメーター：

• format (string, path) – xml または json。
• queryParameters.searchTerm (string, query)
• queryParameters.memberId (number, query)
• queryParameters.includeWhenMemberWasTeller (boolean, query)
• queryParameters.startDate (string, query) – yyyy-MM-dd。
• queryParameters.endDate (string, query) – yyyy-MM-dd。
• queryParameters.divisionNumber (number, query)

ukpcv_divisions_member_voting

議員の投票記録を返します。

パラメーター：

• format (string, path) – xml または json。
• queryParameters.memberId (number, query) – 必須。
• queryParameters.skip (number, query)
• queryParameters.take (number, query)
• queryParameters.searchTerm (string, query)
• queryParameters.includeWhenMemberWasTeller (boolean, query)
• queryParameters.startDate (string, query) – yyyy-MM-dd。
• queryParameters.endDate (string, query) – yyyy-MM-dd。
• queryParameters.divisionNumber (number, query)

ukpcv_divisions_search

採決の一覧を返します。

パラメーター：

• format (string, path) – json または xml。
• queryParameters.skip (number, query)
• queryParameters.take (number, query)
• queryParameters.searchTerm (string, query)
• queryParameters.memberId (number, query)
• queryParameters.includeWhenMemberWasTeller (boolean, query)
• queryParameters.startDate (string, query) – yyyy-MM-dd。
• queryParameters.endDate (string, query) – yyyy-MM-dd。
• queryParameters.divisionNumber (number, query)

ukpcv_divisions_search_total_results

検索結果の総数を返します。

パラメーター：

• format (string, path) – json または xml。
• queryParameters.searchTerm (string, query)
• queryParameters.memberId (number, query)
• queryParameters.includeWhenMemberWasTeller (boolean, query)
• queryParameters.startDate (string, query) – yyyy-MM-dd。
• queryParameters.endDate (string, query) – yyyy-MM-dd。
• queryParameters.divisionNumber (number, query)

出力例

{
  "status": 200,
  "data": {
    "items": [
      {
        "divisionId": 1234,
        "title": "Finance Bill - Third Reading",
        "divisionNumber": 15,
        "date": "2026-03-10"
      }
    ],
    "totalResults": 1
  },
  "upstream_path": "/data/divisions.json/search",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

クイックスタート

npx を使用して MCP サーバーを実行します。

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

MCP 設定

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

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

使用例

• 採決 ID を指定して、採決を JSON 形式で取得します。
• 日付範囲内で、特定の議員に関する採決を検索します。
• 議員の投票記録とページ分けされた結果を取得します。
• ページを取得する前に、検索クエリの総結果数を取得します。

ユースケース

• 庶民院の採決と結果を要約する AI エージェント。
• 議員ごとの投票履歴を追跡する政治分析ツール。
• 採決の傾向を監視する市民テクノロジープラットフォーム。
• レポート作成用に採決データをエクスポートする自動化ワークフロー。

データソース

英国議会庶民院採決 API https://commonsvotes-api.parliament.uk/

インストール

npx を使用して直接実行します。

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

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

pnpm install

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

まずビルドしてから、起動します。

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

UKPCV_HTTP_PORT 環境変数で HTTP ポートをカスタマイズできます（デフォルト：8787）。

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

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

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

シェルで bin を解決できない場合（「コマンドが見つかりません」と表示される場合）は、HTTP エントリポイントを直接実行してください。

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

ヘルスチェック：

curl http://127.0.0.1:8787/healthz

ライセンス

MIT ライセンス

MCP メタデータ

プロトコル：Model Context Protocol トランスポート：stdio ツール：ukpcv_division_get_by_id, ukpcv_divisions_grouped_by_party, ukpcv_divisions_member_voting, ukpcv_divisions_search, ukpcv_divisions_search_total_results