uk-parliament-now

英国議会 NOW Annunciator MCP サーバー

概要

この MCP サーバーは、Model Context Protocol を使用して英国議会 NOW Annunciator のデータに構造化されたアクセスを提供します。 API に基づくツールとデータアクセスを通じて、AI エージェントが現在および過去のアナウンサーのメッセージを取得できるようにします。 開発者は stdio トランスポートを介して MCP サーバーを統合し、Commons と Lords のメッセージフィードを照会できます。 このサーバーは NOW Annunciator API に直接対応するツールを公開し、自動化や AI エージェントのワークフローを実現します。

特長

• Commons または Lords の現在のアナウンサーのメッセージを取得します。
• 特定の日時以降の最新メッセージを取得します。
• 信頼性の高いクエリのため、アナウンサーの列挙型制約を適用します。
• 下流のツールで利用できるよう、上流のペイロードを標準化されたエンベロープ内に保持します。

利用可能なツール

get_current_message_by_annunciator

アナウンサーの種類別に現在のメッセージを返します。

パラメーター：

• annunciator（string、path）– CommonsMain | LordsMain。

get_latest_message_by_annunciator_and_date

指定した日時以降の最新メッセージをアナウンサー別に返します。

パラメーター：

• annunciator（string、path）– CommonsMain | LordsMain。
• date（string、path）– ISO 日時文字列。

出力例

{
  "status": 200,
  "data": {
    "annunciator": "CommonsMain",
    "message": "The House is sitting",
    "timestamp": "2026-03-11T09:00:00Z"
  },
  "upstream_path": "/api/Message/message/CommonsMain/current",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

クイックスタート

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

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

MCP の設定

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

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

使用例

• Commons の現在のアナウンサーのメッセージを取得します。
• 指定したタイムスタンプ以降の最新の Lords のメッセージを取得します。
• 会期の状況が変化した際に、アナウンサーの更新を監視します。

ユースケース

• 議会の状況をリアルタイムで報告する AI エージェント。
• Commons／Lords の会期メッセージを表示する監視ダッシュボード。
• 開会日や告知を追跡するシビックテックツール。
• アナウンサーの更新をトリガーとする自動化ワークフロー。

データソース

英国議会 NOW Annunciator Content API https://now-api.parliament.uk

インストール

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

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

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

pnpm install

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

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

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

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

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

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

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

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

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

ヘルスチェック：

curl http://127.0.0.1:3000/healthz

プロキシのパターン：

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

例：

curl "http://127.0.0.1:3000/proxy/api/Message/message/CommonsMain/current"

ライセンス

MIT License

MCP メタデータ

プロトコル：Model Context Protocol トランスポート：stdio ツール：get_current_message_by_annunciator, get_latest_message_by_annunciator_and_date