boj-jstat-mcp

日本銀行 時系列統計データ検索サイトのAPI機能を利用するMCP（Model Context Protocol）サーバーです。

金利、マネーサプライ、為替レート、短観、国際収支、物価指数など、40以上の日銀統計データベースにClaude/CodexなどのAIアシスタントから直接アクセスできます。

クイックスタート

git clone なしでそのまま使えます。npx -y boj-jstat-mcp@latest を指定すると npm から取得して起動できます。

注意（2026-02-25時点）: boj-mcp@latest は別プロジェクト（solved.ac向け）であり、このリポジトリの日銀MCPではありません。

Claude Desktop

claude_desktop_config.json に以下を追加：

{
  "mcpServers": {
    "boj": {
      "command": "npx",
      "args": ["-y", "boj-jstat-mcp@latest"]
    }
  }
}

Claude Code

追加:

claude mcp add boj -- npx -y boj-jstat-mcp@latest

確認:

claude mcp list

削除:

claude mcp remove boj

Codex CLI

追加:

codex mcp add boj -- npx -y boj-jstat-mcp@latest

確認:

codex mcp list
codex mcp get boj

削除:

codex mcp remove boj

Related MCP server: estat-mcp

使い方（推奨フロー）

1. boj_list_databases でDB候補を絞る

2. boj_get_metadata を limit=20-50 程度で呼び、系列コード/レイヤーを特定

3. boj_get_data_code または boj_get_data_layer で本取得

4. NEXTPOSITION が返ったら startPosition でページング

使用例

物価関連のDBを探す：

「物価に関する日銀のデータベースを一覧表示して」

短観DIデータを取得：

「2024年第1四半期から2025年第4四半期までの短観・大企業製造業の業況判断DIを取得して」

為替レートを確認：

「2025年12月のドル円為替レートデータを見せて」

国際収支を参照：

「2025年1月の国際収支統計から経常収支を取得して」

アクセス可能なデータベース一覧

1. 金利（預金・貸出関連）

2. マーケット関連

3. 決済関連

4. 預金・マネー・貸出

5. 金融機関バランスシート

6. 資金循環

7. その他の日本銀行関連

8. 短観

9. 物価

10. 財政関連

11. 国際収支・BIS関連

12. その他

ツール一覧

boj_list_databases — DB一覧表示

利用可能な日銀統計データベースの一覧を表示します。APIコール不要（静的データ）。

boj_get_metadata — メタデータ取得

データベースのメタデータ（系列コード、名称、単位、期種、階層構造）を取得します。 返却には SERIES_CODE を持つ行のみを表示し、boj_get_data_code で使えない見出し行は除外します。

boj_get_data_code — 系列コード指定データ取得

系列コードを指定して時系列データを取得します。1リクエストあたり最大250系列/60,000データポイント。 code は必ず boj_get_metadata で取得した SERIES_CODE をそのまま指定してください（DB接頭辞や引用符区切りの旧形式は不可）。無効コード時は近い候補を提示し、近似一致が十分高い場合は自動補正して再試行します。

boj_get_data_layer — 階層指定データ取得

階層構造を指定して時系列データを取得します。ワイルドカード * 対応。最大1,250系列/60,000データポイント。

日付パラメータの仕様（重要）

• BOJ API の仕様上、startDate / endDate は期種単位の指定です。

• YYYY-MM-DD と YYYYMMDD を渡した場合、サーバー側で期種フォーマットへ正規化します。

• D（日次）/W（週次）系列でも、BOJ API には YYYYMM 形式で問い合わせます（返却データ自体は日付単位）。

レート制限

BOJの「高頻度アクセスは避けてください」というガイドラインに準拠するため、トークンバケット方式のレートリミッター（容量5、毎秒1トークン補充）を内蔵しています。並列リクエスト時も内部キューで制御し、過剰送信を防ぎます。

動作要件

• Node.js 18.0.0以上

クレジット

このサービスは、日本銀行時系列統計データ検索サイトの API 機能を使用しています。サービスの内容は日本銀行によって保証されたものではありません。