boe-mcp

boe-mcp

Claude Code、または任意の MCP クライアントにイングランド銀行の最新データを提供する MCP（Model Context Protocol）サーバーです。基準金利（現在の水準、変更履歴、任意の期間の統計、過去の任意の日付に適用されていた金利）、BoE の IADB 統計データベースにあるあらゆる系列（SONIA、為替レート、住宅ローン提示金利など数千件。すぐに使える厳選カタログも用意されています）、および金融政策委員会の会合予定を取得できます。デフォルトでは stdio 経由で動作し、リモートホスティング向けに Streamable HTTP モードも任意で利用できます。API キーや設定は不要で、応答をメモリにキャッシュするため、同じ質問を繰り返しても BoE に再度問い合わせることはありません。

ビルドの来歴情報とともに、npm で boe-mcp として公開されています。npx -y boe-mcp でインストールして実行できます。

ツール

get_series は、有効なIADBコードであればカタログにないものも受け付けます。不明または空のコードを指定すると、Unknown or empty IADB series "XXXX" — use list_series for known codes という簡潔なメッセージが返されます。コードを調べるには list_series を使用してください。

BoEに接続できず、以前にキャッシュされた値がある場合、ツールはキャッシュデータを "stale": true として返すため、呼び出し元はその注意事項を示すことができます。キャッシュがない場合は、簡潔なエラーメッセージが返されます。

インストール

Claude Code の settings.json に追加します。

{
  "mcpServers": {
    "boe": {
      "command": "npx",
      "args": ["-y", "boe-mcp"]
    }
  }
}

または、CLIを使用します。

claude mcp add boe -- npx -y boe-mcp

{
  "mcpServers": {
    "boe": {
      "command": "npx",
      "args": ["-y", "boe-mcp"]
    }
  }
}

{
  "mcpServers": {
    "boe": {
      "command": "npx",
      "args": ["-y", "boe-mcp"]
    }
  }
}

{
  "servers": {
    "boe": {
      "command": "npx",
      "args": ["-y", "boe-mcp"]
    }
  }
}

デフォルトでは、サーバーはクライアントの子プロセスとして stdio 経由で MCP 通信を行います。代わりにリモートでホストするには、Streamable HTTP モードで起動します。

npx -y boe-mcp --http                  # listen on http://127.0.0.1:3000/mcp
npx -y boe-mcp --http 8080             # explicit port
BOE_MCP_HTTP_PORT=8080 npx -y boe-mcp  # env var instead of the flag

エンドポイント：POST /mcp（JSON-RPC）、GET /healthz（ok を返します。ホスティングプラットフォームのヘルスチェック用です）。トランスポートはステートレスです。各 POST は新しいサーバーインスタンスで処理されるため、再開するセッションも SSE ストリームもありません。GET／DELETE /mcp は 405 を返します。そのため、ロードバランサーの背後でインスタンスを安全に水平スケールできます。

curl で試すには：

curl -X POST http://127.0.0.1:3000/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'

セキュリティ：デフォルトのバインド先 127.0.0.1 はローカルマシンからの接続のみを受け付け、ループバックへのバインドでは DNS リバインディング対策（Host ヘッダーの検証）が自動的に有効になります。BOE_MCP_HTTP_HOST=0.0.0.0 を設定すると、認証なしで、マシンが接続しているすべてのネットワークにサーバーが公開されます。接続可能なユーザーを制御するリバースプロキシまたはファイアウォールの背後でのみ設定してください（サーバーは正規のパブリックホスト名を把握できないため、ループバック以外へのバインドでは DNS リバインディング対策が無効になります）。

設定

データソース

• 基準金利：イングランド銀行の Statistical Interactive Database（IADB）の系列 IUDBEDR。公開 CSV エンドポイント経由で取得します。認証もキーも不要です。注意点として、IADB は公開 API として正式に文書化されていません。長年安定しており広く利用されていますが、イングランド銀行は互換性を保証していないため、原理上は互換性を損なう変更が起こる可能性があります。
• MPC の日程：イングランド銀行の公開ページ今後の MPC 日程から解析します。パーサーは意図的にページのマークアップに依存せず、表示テキストから日付を検索するため、見た目の変更では動作に影響しません。

ソースから実行する

git clone https://github.com/moureauf/boe-mcp.git
cd boe-mcp
npm install
npm run build
npm start            # runs the stdio server

コントリビューションとリリース

開発ワークフロー（変更、テスト、ツールの追加、バージョン管理）と、リリースパイプラインが GitHub、npm、MCP レジストリとどのように連携するかについては、CONTRIBUTING.md を参照してください。公開は自動化されています。v* タグをプッシュすると .github/workflows/publish.yml が実行され、ビルド、テストを行い、信頼済みパブリッシング（OIDC を使用。トークンシークレットは不要で、プロベナンス証明書が付与されます）経由で npm に公開し、公式 MCP レジストリにも公開します。具体的なコマンドと初回のみ必要な設定については、RELEASING.md を参照してください。

ライセンス

MIT