uk-parliament-questions-statements

英国議会の質問および声明 MCP サーバー

概要

この MCP サーバーは、Model Context Protocol を使用して、英国議会の質問および声明データに構造化された方法でアクセスできます。 AI エージェントは、API と連携するツールおよびデータアクセスを通じて、日次レポート、書面質問、書面声明を取得できます。 開発者は、stdio トランスポートを介して MCP サーバーを統合し、質問の検索、会期ステータスによる絞り込み、声明の詳細の取得を行えます。 このサーバーは、Questions and Statements API に直接対応するツールを公開し、信頼性の高い自動化と AI エージェントのワークフローを実現します。

機能

• 日付と院によるフィルターを指定して、日次レポートの一覧を取得します。
• 回答状況、議員、会期のフィルターを指定して、書面質問を検索します。
• ID または日付／uin を指定して、書面質問および声明を取得します。
• ダウンストリームツールで利用できるよう、アップストリームのペイロードを標準化されたエンベロープに保持します。

利用可能なツール

list_daily_reports

日次レポートの一覧を返します。

パラメーター：

• dateFrom (string, query)
• dateTo (string, query)
• house (string, query) – Bicameral | Commons | Lords
• skip (number, query)
• take (number, query)

list_written_questions

書面質問の一覧を返します。

パラメーター：

• askingMemberId (number, query)
• answeringMemberId (number, query)
• tabledWhenFrom (string, query)
• tabledWhenTo (string, query)
• dateForAnswerWhenFrom (string, query)
• dateForAnswerWhenTo (string, query)
• answered (string, query) – Any | Answered | Unanswered
• answeredWhenFrom (string, query)
• answeredWhenTo (string, query)
• questionStatus (string, query) – NotAnswered | AnsweredOnly | AllQuestions
• includeWithdrawn (boolean, query)
• expandMember (boolean, query)
• correctedWhenFrom (string, query)
• correctedWhenTo (string, query)
• sessionStatus (string, query) – Current | Any
• searchTerm (string, query)
• uIN (string, query)
• answeringBodies (array:number, query)
• members (array:number, query)
• house (string, query) – Bicameral | Commons | Lords
• skip (number, query)
• take (number, query)

get_written_question_by_id

書面質問を返します。

パラメーター：

• id (number, path)
• expandMember (boolean, query)
• sessionStatus (string, query) – Current | Any

get_written_question_by_date_and_uin

書面質問を返します。

パラメーター：

• date (string, path)
• uin (string, path)
• expandMember (boolean, query)
• sessionStatus (string, query) – Current | Any

list_written_statements

書面声明の一覧を返します。

パラメーター：

• madeWhenFrom (string, query)
• madeWhenTo (string, query)
• sessionStatus (string, query) – Current | Any
• searchTerm (string, query)
• uIN (string, query)
• answeringBodies (array:number, query)
• members (array:number, query)
• house (string, query) – Bicameral | Commons | Lords
• skip (number, query)
• take (number, query)
• expandMember (boolean, query)

get_written_statement_by_id

書面声明を返します。

パラメーター：

• id (number, path)
• expandMember (boolean, query)
• sessionStatus (string, query) – Current | Any

get_written_statement_by_date_and_uin

書面声明を返します。

パラメーター：

• date (string, path)
• uin (string, path)
• expandMember (boolean, query)
• sessionStatus (string, query) – Current | Any

出力例

{
  "status": 200,
  "data": {
    "items": [
      {
        "id": 12345,
        "uin": "12345",
        "title": "Example written question",
        "house": "Commons"
      }
    ],
    "totalResults": 1
  },
  "upstream_path": "/api/writtenquestions/questions",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

クイックスタート

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

npx -y -p @darkhorseone/mcp-server-uk-parliament-questions-statements mcp-server-uk-parliament-questions-statements

MCP の設定

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

{
  "mcpServers": {
    "uk-parliament-questions-statements": {
      "command": "npx",
      "args": ["-y", "-p", "@darkhorseone/mcp-server-uk-parliament-questions-statements", "mcp-server-uk-parliament-questions-statements"],
      "env": {
        "UPSTREAM_BASE_URL": "https://questions-statements-api.parliament.uk",
        "REQUEST_TIMEOUT_MS": "10000"
      }
    }
  }
}

使用例

• 日付範囲を指定して、Commons の日次レポートを一覧表示します。
• 議員と会期ステータスを指定して、書面質問を検索します。
• ID または日付／uin を指定して、書面声明を取得します。
• 回答状況と院を指定して、質問を絞り込みます。

ユースケース

• 書面質問および声明を要約する AI エージェント。
• 議会質問の経時的な追跡に使用する調査ツール。
• 部門別の声明を監視するシビックテックプラットフォーム。
• 日次レポートデータをエクスポートする自動化ワークフロー。

データソース

英国議会質問・声明 API https://questions-statements-api.parliament.uk

インストール

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

npx -y -p @darkhorseone/mcp-server-uk-parliament-questions-statements mcp-server-uk-parliament-questions-statements

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

pnpm install

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

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

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

UKP_HTTP_PORT 環境変数でカスタム HTTP ポートを設定できます（デフォルト：8787）：

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

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

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

シェルで bin を解決できない場合（「command not found」）、HTTP エントリーポイントを直接実行してください：

npx -y -p @darkhorseone/mcp-server-uk-parliament-questions-statements -- 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/writtenquestions/questions?searchTerm=health&take=10"

ライセンス

MIT ライセンス

MCP メタデータ

プロトコル：Model Context Protocol トランスポート：stdio ツール：list_daily_reports, list_written_questions, get_written_question_by_id, get_written_question_by_date_and_uin, list_written_statements, get_written_statement_by_id, get_written_statement_by_date_and_uin