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

使い方（推奨フロー）

boj_list_databases でDB候補を絞る
boj_get_metadata を limit=20-50 程度で呼び、系列コード/レイヤーを特定
boj_get_data_code または boj_get_data_layer で本取得
NEXTPOSITION が返ったら startPosition でページング

使用例

物価関連のDBを探す：

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

短観DIデータを取得：

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

為替レートを確認：

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

国際収支を参照：

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

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

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

DBコード	説明
IR01	基準割引率および基準貸付利率（従来「公定歩合」として掲載されていたもの）の推移
IR02	預金種類別店頭表示金利の平均年利率等
IR03	定期預金の預入期間別平均金利
IR04	貸出約定平均金利

2. マーケット関連

DBコード	説明
FM01	無担保コールO/N物レート（毎営業日）
FM02	短期金融市場金利
FM03	短期金融市場残高
FM04	コール市場残高
FM05	公社債発行・償還および現存額
FM06	公社債消化状況（利付国債）
FM07	（参考）国債窓口販売額・窓口販売率（2004年1月まで）
FM08	外国為替市況
FM09	実効為替レート

3. 決済関連

DBコード	説明
PS01	各種決済
PS02	フェイルの発生状況

4. 預金・マネー・貸出

DBコード	説明
MD01	マネタリーベース
MD02	マネーストック
MD03	マネタリーサーベイ
MD04	（参考）マネーサプライ（M2+CD）増減と信用面の対応
MD05	通貨流通高
MD06	日銀当座預金増減要因と金融調節（実績）
MD07	準備預金額
MD08	業態別の日銀当座預金残高
MD09	マネタリーベースと日本銀行の取引
MD10	預金者別預金
MD11	預金・現金・貸出金
MD12	都道府県別預金・現金・貸出金
MD13	貸出・預金動向
MD14	定期預金の残高および新規受入高
LA01	貸出先別貸出金
LA02	日本銀行貸出
LA03	その他貸出残高
LA04	コミットメントライン契約額、利用額
LA05	主要銀行貸出動向アンケート調査

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

DBコード	説明
BS01	日本銀行勘定
BS02	民間金融機関の資産・負債

6. 資金循環

DBコード	説明
FF	資金循環

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

DBコード	説明
OB01	日本銀行の対政府取引
OB02	日本銀行が受入れている担保の残高

8. 短観

DBコード	説明
CO	短観

9. 物価

DBコード	説明
PR01	企業物価指数
PR02	企業向けサービス価格指数
PR03	製造業部門別投入・産出物価指数
PR04	＜サテライト指数＞最終需要・中間需要物価指数

10. 財政関連

DBコード	説明
PF01	財政資金収支
PF02	政府債務

11. 国際収支・BIS関連

DBコード	説明
BP01	国際収支統計
BIS	BIS国際資金取引統計および国際与信統計の日本分集計結果
DER	デリバティブ取引に関する定例市場報告

12. その他

DBコード	説明
OT	その他

ツール一覧

`boj_list_databases` — DB一覧表示

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

パラメータ	必須	説明
`category`	いいえ	カテゴリでフィルタ
`search`	いいえ	コードまたは名前で検索

`boj_get_metadata` — メタデータ取得

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

パラメータ	必須	説明
`db`	はい	DBコード（例：`CO`）
`lang`	いいえ	`jp`（デフォルト）または `en`
`limit`	いいえ	返却件数上限（デフォルト200、最大1000）

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

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

パラメータ	必須	説明
`db`	はい	DBコード
`code`	はい	カンマ区切りの系列コード（同一期種のみ）
`lang`	いいえ	`jp`（デフォルト）または `en`
`startDate`	いいえ	開始期（形式は期種に依存）
`endDate`	いいえ	終了期
`startPosition`	いいえ	ページネーション（前回のNEXTPOSITION値）

`boj_get_data_layer` — 階層指定データ取得

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

パラメータ	必須	説明
`db`	はい	DBコード
`layer`	はい	カンマ区切りの階層値（例：`1,1,1`）、`*` で全指定
`frequency`	はい	`CY`, `FY`, `CH`, `FH`, `Q`, `M`, `W`, `D`
`lang`	いいえ	`jp`（デフォルト）または `en`
`startDate`	いいえ	開始期
`endDate`	いいえ	終了期
`startPosition`	いいえ	ページネーション（前回のNEXTPOSITION値）

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

BOJ API の仕様上、startDate / endDate は期種単位の指定です。
YYYY-MM-DD と YYYYMMDD を渡した場合、サーバー側で期種フォーマットへ正規化します。
D（日次）/W（週次）系列でも、BOJ API には YYYYMM 形式で問い合わせます（返却データ自体は日付単位）。

レート制限

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

動作要件

Node.js 18.0.0以上

クレジット

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