uk-parliament-erskinemay

UK Parliament Erskine May MCP Server

概要

この MCP サーバーは、Model Context Protocol を使用して、英国議会の Erskine May コンテンツに構造化された形式でアクセスできるようにします。 AI エージェントが、API を利用したツールを通じて章、パート、セクション、索引語を検索できるため、信頼性の高いデータアクセスが可能になります。 開発者は、stdio トランスポート経由で MCP サーバーに接続し、信頼できる議事手続きのガイダンスと参考情報を取得できます。 このサーバーは、検索や参照のワークフロー向けに、Erskine May API に直接対応するツールを提供します。

機能

• 識別子を指定して、章、パート、セクション、セクションの概要を取得します。
• キーワードで索引語や段落を閲覧、検索します。
• 一貫したレスポンス形式で、構造化された参照をサポートします。
• 下流のツールや AI エージェント向けに、上流の JSON ペイロードを保持します。

利用可能なツール

get_chapter_by_chapter_number

章番号で単一の章の概要を返します。

パラメーター：

• chapterNumber (number, path) – 章番号。

browse_index_terms

先頭の文字を指定して、索引語の一覧を返します。

パラメーター：

• startLetter (string, query)
• skip (number, query)
• take (number, query)

get_index_term_by_index_term_id

ID で索引語を返します。

パラメーター：

• indexTermId (number, path) – 索引語 ID。

list_parts

すべてのパートの一覧を返します。

get_part_by_part_number

パート番号でパートを返します。

パラメーター：

• partNumber (number, path) – パート番号。

search_index_term_results_by_search_term

検索語を含む索引語の一覧を返します。

パラメーター：

• searchTerm (string, path)
• skip (number, query)
• take (number, query)

get_paragraph_by_reference

参照を指定してセクションの概要を返します。

パラメーター：

• reference (string, path)

search_paragraph_results_by_search_term

検索語を含む段落の一覧を返します。

パラメーター：

• searchTerm (string, path)
• skip (number, query)
• take (number, query)

search_section_results_by_search_term

検索語を含むセクションの一覧を返します。

パラメーター：

• searchTerm (string, path)
• skip (number, query)
• take (number, query)

get_section_by_section_id

セクション ID でセクションを返します。

パラメーター：

• sectionId (number, path)

get_section_overview_by_section_id_and_step

セクション ID とステップを指定して、セクションの概要を返します。

パラメーター：

• sectionId (number, path)
• step (number, path)

出力例

{
  "status": 200,
  "data": {
    "sectionId": 12,
    "title": "Order in debate",
    "content": "..."
  },
  "upstream_path": "/api/Section/12",
  "retrieved_at": "2026-03-11T10:00:00.000Z"
}

クイックスタート

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

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

MCP の設定

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

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

使用例

• 章番号を指定して章を取得します。
• キーワードでセクションを検索し、結果をページ分割します。
• ID とステップを指定してセクションの概要を取得します。
• 文字で始まる索引語を閲覧します。

ユースケース

• 信頼できる参考情報を用いて、議事手続きに関する質問に回答する AI エージェント。
• セクションや段落を対応付ける法律・議会調査ツール。
• Erskine May の参考情報でデータセットを拡充するシビックテックのワークフロー。
• 議事手続きに関するコンテンツを検索用にインデックス化する自動化システム。

データソース

英国議会 Erskine May API https://erskinemay-api.parliament.uk

インストール

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

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

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

pnpm install

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

最初にビルドしてから、起動します。

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

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

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

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

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

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

npx -y -p @darkhorseone/mcp-server-uk-parliament-erskinemay -- 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/Part"

ライセンス

MIT License

MCP メタデータ

プロトコル：Model Context Protocol トランスポート：stdio ツール：get_chapter_by_chapter_number、browse_index_terms、get_index_term_by_index_term_id、list_parts、get_part_by_part_number、search_index_term_results_by_search_term、get_paragraph_by_reference、search_paragraph_results_by_search_term、search_section_results_by_search_term、get_section_by_section_id、get_section_overview_by_section_id_and_step