uk-parliament-interests

英国議会利益登録簿 MCP サーバー

概要

この MCP サーバーは、Model Context Protocol を使用して英国議会利益登録簿への構造化されたアクセスを提供します。 AI エージェントは、API を利用したツールとデータアクセスを通じて、利益のカテゴリー、公開済みの登録簿、利益の記録を照会できます。 開発者は、stdio トランスポート経由で MCP サーバーを統合し、分析ワークフローに必要な登録簿、利益、PDF を取得できます。 このサーバーは、AI エージェントや開発者向けツールに最適化された、利益登録簿 API に直接対応するツールを公開します。

特徴

• 利益のカテゴリー一覧を取得し、ID でカテゴリーの詳細を取得します。
• 公開済みの登録簿、登録簿の PDF、登録簿のメタデータを取得します。
• 会員、日付、カテゴリーでフィルターして利益を照会します。
• 下流のツールや AI エージェントで利用できるよう、上流のペイロードを標準化されたエンベロープで保持します。

利用可能なツール

ukpi_categories_list

利益を登録するカテゴリーの一覧を、カテゴリー番号順に返します。

パラメーター：

• Skip (number、query) – スキップするレコード数。
• Take (number、query) – 取得するレコード数。

ukpi_categories_get_by_id

ID で利益カテゴリーの詳細を返します。

パラメーター：

• id (number、path) – カテゴリー ID。

ukpi_interests_list

登録簿に公開された利益の一覧を返します。

パラメーター：

• MemberId (number、query)
• CategoryId (number、query)
• PublishedFrom (string、query)
• PublishedTo (string、query)
• RegisteredFrom (string、query)
• RegisteredTo (string、query)
• UpdatedFrom (string、query)
• UpdatedTo (string、query)
• RegisterId (number、query)
• ExpandChildInterests (boolean、query)
• Take (number、query)
• SortOrder (string、query) – PublishingDateDescending | CategoryAscending
• Skip (number、query)

ukpi_interests_csv

利益を ZIP ファイルにまとめた CSV として返します。

パラメーター：

• MemberId (number、query)
• CategoryId (number、query)
• PublishedFrom (string、query)
• PublishedTo (string、query)
• RegisteredFrom (string、query)
• RegisteredTo (string、query)
• UpdatedFrom (string、query)
• UpdatedTo (string、query)
• RegisterId (number、query)
• IncludeFieldDescriptions (boolean、query)

ukpi_interests_get_by_id

公開済みの利益の最新バージョンを返します。

パラメーター：

• id (number、path) – 利益 ID。

ukpi_registers_list

公開済みの利益登録簿のバージョン一覧を返します。

パラメーター：

• SessionId (number、query)
• Skip (number、query)
• Take (number、query)

ukpi_registers_get_by_id

ID で公開済みの利益登録簿のバージョンを返します。

パラメーター：

• id (number、path) – 登録簿 ID。

ukpi_registers_document

ID で公開済みの登録簿を PDF ドキュメントとして返します。

パラメーター：

• id (number、path) – 登録簿 ID。
• type (string、query) – Full | Updated

出力例

{
  "status": 200,
  "data": {
    "items": [
      {
        "interestId": 9876,
        "memberId": 123,
        "categoryId": 2,
        "publishedDate": "2026-03-01"
      }
    ],
    "totalResults": 1
  },
  "upstream_path": "/api/v1/Interests",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

クイックスタート

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

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

MCP 設定

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

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

使用例

• 会員の公開済みの利益を一覧表示します。
• 特定の利益を ID で取得します。
• 議会会期の登録簿を取得します。
• 最新の登録簿 PDF をダウンロードします。

ユースケース

• 透明性に関する報告のため、会員の利益を要約する AI エージェント。
• 公開済み登録簿の更新を追跡するコンプライアンスワークフロー。
• カテゴリーや日付ごとに利益を集約する調査ツール。
• 登録簿データの変更を監視するシビックテクノロジープラットフォーム。

データソース

英国議会利益登録簿 API https://interests-api.parliament.uk/

インストール

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

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

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

pnpm install

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

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

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

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

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

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

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

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

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

ヘルスチェック：

curl http://127.0.0.1:8787/healthz

ライセンス

MIT ライセンス

MCP メタデータ

プロトコル：Model Context Protocol トランスポート：stdio ツール：ukpi_categories_list, ukpi_categories_get_by_id, ukpi_interests_list, ukpi_interests_csv, ukpi_interests_get_by_id, ukpi_registers_list, ukpi_registers_get_by_id, ukpi_registers_document