uk-parliament-statutoryinstruments

英国議会法定文書 MCP サーバー

概要

この MCP サーバーは、Model Context Protocol を使用して、英国議会の法定文書データに構造化されたアクセスを提供します。 AI エージェントが API ベースのツールとデータアクセスを通じて、法定文書、手続き、提出機関、議事項目を検索できるようにします。 開発者は stdio トランスポートを介して MCP サーバーを統合し、v1 と v2 のエンドポイントから法定文書を取得できます。 このサーバーは、信頼性の高い自動化と AI エージェントのワークフローを実現するため、法定文書 API に直接対応するツールを公開します。

特長

• 議院、手続き、ステータスで絞り込み、法定文書と否決予定の法定文書を検索します。
• ID を指定して、文書の詳細、手続き、議事項目を取得します。
• v1 と v2 のエンドポイントを通じて、提出機関と議会制定法にアクセスします。
• 下流のツールで利用できるよう、上流のペイロードを標準化されたエンベロープで保持します。

利用可能なツール

get_v1_business_item_by_id

ID で議事項目を返します。

Parameters:

• id (string, path)
• LaidPaper (string, query) – StatutoryInstrument | ProposedNegative

list_v1_laying_bodies

すべての提出機関を返します。

list_v1_procedures

すべての手続きを返します。

get_v1_procedure_by_id

ID で手続きを返します。

Parameters:

• id (string, path)

list_v1_proposed_negative_statutory_instruments

否決予定の法定文書の一覧を返します。

Parameters:

• Name (string, query)
• RecommendedForProcedureChange (boolean, query)
• DepartmentId (number, query)
• LayingBodyId (string, query)
• Skip (number, query)
• Take (number, query)

get_v1_proposed_negative_statutory_instrument_by_id

ID で否決予定の法定文書を返します。

Parameters:

• id (string, path)

list_v1_business_items_by_proposed_negative_statutory_instrument_id

否決予定の法定文書に属する議事項目を返します。

Parameters:

• id (string, path)

list_v1_statutory_instruments

法定文書の一覧を返します。

Parameters:

• Name (string, query)
• StatutoryInstrumentType (string, query) – DraftAffirmative | DraftNegative | MadeAffirmative | MadeNegative
• ScheduledDebate (boolean, query)
• MotionToStop (boolean, query)
• ConcernsRaisedByCommittee (boolean, query)
• ParliamentaryProcessConcluded (string, query) – NotConcluded | Concluded
• DepartmentId (number, query)
• LayingBodyId (string, query)
• House (string, query) – Commons | Lords
• Skip (number, query)
• Take (number, query)

get_v1_statutory_instrument_by_id

ID で法定文書を返します。

Parameters:

• id (string, path)

list_v1_business_items_by_statutory_instrument_id

指定した ID の法定文書に属する議事項目を返します。

Parameters:

• id (string, path)

list_v2_acts_of_parliament

議会制定法を検索します。

Parameters:

• Id (array:string, query)
• Name (string, query)

get_v2_act_of_parliament_by_id

ID で個別の議会制定法を検索します。

Parameters:

• id (string, path)

list_v2_statutory_instruments

法定文書と否決予定の法定文書を検索します。

Parameters:

• Name (string, query)
• Procedure (string, query)
• ScheduledDebate (boolean, query)
• MotionToStop (boolean, query)
• ConcernsRaisedByCommittee (boolean, query)
• ParliamentaryProcessConcluded (boolean, query)
• DepartmentId (number, query)
• LayingBodyId (string, query)
• RecommendedForProcedureChange (boolean, query)
• ActOfParliamentId (array:string, query)
• House (string, query) – Commons | Lords
• Skip (number, query)
• Take (number, query)

get_v2_statutory_instrument_by_instrument_id

ID で個別の法定文書または否決予定の法定文書を取得します。

Parameters:

• instrumentId (string, path)

list_v2_business_items_by_instrument_id

特定の文書に関連する議事項目を取得します。

Parameters:

• instrumentId (string, path)

list_v2_business_items_by_timeline_id

特定のタイムラインに関連する議事項目を取得します。

Parameters:

• timelineId (string, path)

出力例

{
  "status": 200,
  "data": {
    "items": [
      {
        "instrumentId": "abcd1234",
        "name": "Example Statutory Instrument",
        "house": "Commons"
      }
    ],
    "totalResults": 1
  },
  "upstream_path": "/api/v2/StatutoryInstrument",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

クイックスタート

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

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

MCP 設定

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

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

使用例

• 名称で絞り込み、庶民院に提出された法定文書を一覧表示します。
• ID で法定文書を取得し、その手続きを確認します。
• 法定文書またはタイムラインの議事項目を取得します。
• 法定文書に関連付けられた英国議会制定法を検索します。

ユースケース

• 法定文書の状況と手続きを要約する AI エージェント。
• 省庁または議院ごとに法定文書を追跡する調査ツール。
• 否決動議や討論を監視するシビックテックプラットフォーム。
• レポート作成用に法定文書のメタデータをエクスポートする自動化ワークフロー。

データソース

英国議会法定文書 API https://statutoryinstruments-api.parliament.uk

インストール

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

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

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

pnpm install

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

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

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

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

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

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

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

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

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

ライセンス

MIT License

MCP メタデータ

プロトコル：Model Context Protocol トランスポート：stdio ツール：get_v1_business_item_by_id, list_v1_laying_bodies, list_v1_procedures, get_v1_procedure_by_id, list_v1_proposed_negative_statutory_instruments, get_v1_proposed_negative_statutory_instrument_by_id, list_v1_business_items_by_proposed_negative_statutory_instrument_id, list_v1_statutory_instruments, get_v1_statutory_instrument_by_id, list_v1_business_items_by_statutory_instrument_id, list_v2_acts_of_parliament, get_v2_act_of_parliament_by_id, list_v2_statutory_instruments, get_v2_statutory_instrument_by_instrument_id, list_v2_business_items_by_instrument_id, list_v2_business_items_by_timeline_id