BCB BR MCP

Name: BCB BR MCP
Author: SidneyBissoli

リモート

bcb.sidneybissoli.com金融データ101 日前に更新

リポジトリ公式サイト

BCB BR MCP について

BCB BR MCPは、ブラジル中央銀行のデータを照会するMCPサーバーです。SGS時系列、Focus市場予想、PTAX為替レートを扱い、過去データの取得や指標比較、検索、最新値の確認に対応します。

主な機能

01SGS時系列の照会
02Focus市場予想の取得
03PTAX為替レートの照会
04指標カタログの検索と閲覧
05系列の比較と変化率の計算

活用シーン

01SelicやIPCAの指標を確認
02期間を指定して経済系列を分析
03インフレ指標や為替レートを比較
04経済指標に関する市場予想を確認

MCP 対応

MCPクライアントに、照会ツール、読み取り専用カタログのリソース、定型プロンプトを提供します。データはブラジル中央銀行の公開APIから取得します。

#mcp #brazil #central-bank #bcb #economic-data #financial-data #selic #ipca #exchange-rate #inflation #gdp #time-series

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://bcb.sidneybissoli.com/mcp

インストールコマンドをコピー

Claude CodeTerminalclaude mcp add --transport http bcb-br https://bcb.sidneybissoli.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"bcb-br":{"type":"http","url":"https://bcb.sidneybissoli.com/mcp"}}}Cursor で開く

VS Code.vscode/mcp.json{"servers":{"bcb-br":{"type":"http","url":"https://bcb.sidneybissoli.com/mcp"}}}VS Code で開く

Claude Desktopclaude_desktop_config.json{"mcpServers":{"bcb-br":{"type":"http","url":"https://bcb.sidneybissoli.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"bcb-br":{"serverUrl":"https://bcb.sidneybissoli.com/mcp"}}}

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

パッケージ

npmbcb-br-mcp1.19.0stdio

ツール

パラメーター	型	必須	説明
codigo	number	はい	SGS/BCB の系列コード（例：433 は月次 IPCA、11 は Selic）
dataInicial	string	いいえ	Data inicial no formato yyyy-MM-dd ou dd/MM/yyyy (opcional)
dataFinal	string	いいえ	Data final no formato yyyy-MM-dd ou dd/MM/yyyy (opcional)
frequencia	enum	いいえ	Opcional: reamostra a série para esta frequência antes de responder (só agrega para períodos MAIORES; pedir frequência mais fina que a da série é recusado). Útil para comparar séries de periodicidades diferentes.mensal \| trimestral \| anual
agregacao	enum	いいえ	Como agregar os valores de cada período quando `frequencia` é informada. `ultimo` (padrão) serve a nível de preço, taxa e índice; `soma` a fluxo; `acumulada` a séries que JÁ SÃO variação percentual (IPCA mensal, por exemplo), compondo geometricamente — somar 12 variações mensais NÃO dá a inflação do ano.ultimo \| primeiro \| media \| soma \| acumulada

詳細

ブラジル中央銀行（BCB）— SGS 時系列 MCP サーバー

ポルトガル語で読む

ブラジル中央銀行（Banco Central do Brasil、BCB）向けの MCP（Model Context Protocol）サーバーです。SGS 時系列（SGS/BCB）、Focus 市場予想調査（Olinda OData API 経由）、PTAX 為替レートを提供します。

Selic（金利）、IPCA（インフレ率）、為替レート、GDP などの経済・金融指標を、Claude などの AI アシスタントから直接照会できます。

このプロジェクトが役に立った場合は、GitHubでスターを付けることをご検討ください。他の人がこのプロジェクトを見つけやすくなります！

機能： 17 個のツール（スキル）・3 個のリソース・3 個のプロンプト — MCP クライアントがブラジル中央銀行に照会するために必要なすべてを備えています。SGS/BCB 時系列、Focus 市場予想調査、PTAX 為替レートに対応します。

動作例

自然なポルトガル語でアシスタントに質問できます。

「現在のSelic金利はいくらですか？」 → bcb_indicadores_atuais
「2024年のIPCAを月ごとに表示してください。」 → bcb_serie_valores
「過去12か月間のドルの変動率はいくらですか？」 → bcb_variacao
「市場は2027年のIPCAをどのように予想していますか？」 → bcb_focus_expectativas
「次回のCopom会合でSelicはどの水準になると予想されていますか？」 → bcb_focus_selic
「金曜日のユーロのPTAX終値はいくらでしたか？」 → bcb_cambio_cotacao

回答はブラジル中央銀行のSGS APIからリアルタイムで取得されます。学習データから推測した数値ではなく、出典が明確な正確な数値を提供します。

機能

過去のデータ - コードと日付フィルターを指定して時系列データを取得します
最新値 - 任意の系列の最新の N 件の値を取得します
メタデータ - 系列の詳細情報（頻度、ソースなど）を取得します
人気系列カタログ - ソースと照合済みの 135 件の経済指標をカテゴリ別に掲載しています
スマート検索 - キーワードで系列を検索します（アクセント記号の有無を区別しません）
現在の指標 - 主要な経済指標の最新値を取得します
長期間にも対応 - BCB API は日次系列を 10 年の期間に制限し（HTTP 406）、終了日を指定しない期間も受け付けません。リクエストは自動的に分割され、取得後に結合されるため、15 年分の日次データも問題なく取得できます
頻度の調整 - 明示的な規則に従って、系列を月次、四半期、年次に再サンプリングします。すでに変化率である系列には、幾何累積も適用できます（月次 IPCA を年次 IPCA に変換）
変化率の計算 - 統計情報とともに期間間の変化率を計算します
系列の比較 - 同じ期間の複数の系列を比較し、周期性が異なる場合は警告します
Focus 調査 - IPCA、GDP、為替などの市場予想（平均値、中央値、標準偏差、最小値、最大値、回答者数）を、月次／四半期／年次の期間、または直近 12／24 か月のインフレ率について取得できます。また、Copom 会合ごとの Selic 金利予想も取得できます
PTAX 為替レート - BCB が公表する任意の通貨の公式終値を、単日または日付範囲で取得できます

📖 記事（ポルトガル語）： Séries do Banco Central: como consultar o SGS, a Focus e a PTAX sem cair nas armadilhas — 3 つの API 制限を実測し、レベル系列と変化率系列、Focus の対象範囲、ODbL の要件について解説しています。ポルトガル語版と英語版はサイトでも公開されています：sidneybissoli.com。

利用可能なツール

ツール	説明
`bcb_serie_valores`	コードと日付範囲を指定して系列の値を取得します。長期間は自動的に分割され、系列をより粗い頻度に調整することもできます
`bcb_serie_ultimos`	系列の最新 N 件の値を取得します（任意の N を指定可能。上流側の上限 20 件を回避します）
`bcb_serie_metadados`	系列のメタデータ（名前、頻度、カテゴリ、最新値）を取得します
`bcb_series_populares`	人気系列をカテゴリ別に一覧表示します
`bcb_buscar_serie`	名前または説明で系列を検索します（アクセント記号の有無を区別せず、単語間は AND 検索。日常的な表現は BCB の表記に置き換えられ、その旨が応答に示されます）
`bcb_indicadores_atuais`	最新値：Selic、IPCA、USD/BRL、IBC-Br
`bcb_variacao`	期間内の系列の変化率を計算します。レベル系列の場合はレベルの変化、すでに期間ごとの変化率である系列（IPCA、IGP-M、INPC…）の場合は累積変化率を計算します。どちらの方法を使ったかは `analise.metodo` に示されます
`bcb_comparar`	同じ期間の 2～5 系列を順位付けして比較します（各系列に同じレベル／累積の規則を適用し、使用した方法を `metodo` に示します）
`bcb_focus_expectativas`	指標ごとの Focus 調査の予想を取得します。期間はパラメーターで指定します（月次、四半期、年次、直近 12／24 か月のインフレ率）。`top5` フラグを指定できます
`bcb_focus_selic`	Copom 会合ごとの Selic 金利に関する Focus 予想を取得します（R1/2026 形式）
`bcb_focus_referencias`	Focus 調査で実際に公表されている指標と参照日を、対象範囲ごとに示します（5 つの期間に加え、軸が Copom 会合となる `selic` を含みます）。対象範囲によって指標の種類は異なります（月次は 9 件、年次は 26 件）
`bcb_cambio_cotacao`	通貨（デフォルトは USD）の PTAX 為替レートを、単日または日付範囲で取得します
`bcb_cambio_moedas`	BCB が為替レートを公表している通貨を一覧表示します
`search`	OpenAI Deep Research の仕様：系列カタログ（厳選データとオープンデータポータルのインデックス）を検索し、`{ id, title, url }` を返します。ChatGPT（Deep Research）を参照してください
`fetch`	OpenAI Deep Research の仕様：1 つの系列を、正規の公開 URL を含む読みやすいドキュメントとして返します

リソース

サーバーが MCP リソースとして公開する参照カタログ（クライアントが添付できる読み取り専用のコンテキストデータ）：

URI	説明
`bcb://series/populares`	カテゴリー別に整理された、検証済みの BCB 経済時系列 135 件のカタログ（JSON）
`bcb://series/categorias`	時系列カタログで利用可能なカテゴリーの一覧（JSON）
`bcb://series/principais`	最もよく使われる指標のコード — Selic、IPCA、USD/BRL、GDP など（JSON）

プロンプト

サーバーが MCP プロンプトとして提供するすぐに使えるテンプレート：

プロンプト	説明
`indicadores_atuais`	ブラジルの主要経済指標（Selic、IPCA、USD/BRL、IBC-Br）を照会します
`panorama_economico`	ブラジル経済の包括的な概況を生成します
`comparar_inflacao`	過去 12 か月間のブラジルの主要インフレ指数（IPCA、IGP-M、INPC）を比較します

インストール

Smithery 経由（推奨）

Smithery の bcb-br-mcp にアクセスし、お使いの MCP クライアント向けのインストール手順に従ってください。

URL 経由（Claude.ai、Claude Desktop、任意の MCP クライアント）

インストールせずに HTTP エンドポイントを直接使用します：

https://bcb.sidneybissoli.com/mcp

従来のホスト名 https://bcb.sidneybissoli.workers.dev も引き続き動作し、以前の POST / ルートも同様に利用できます。エンドポイントが /mcp に移動する前に設定されたクライアントは透過的に書き換えられるため、以前動作していた機能が使えなくなることはありません。新しく設定する場合は、上記の URL を使用してください。

npx 経由（Claude Desktop）

Claude Desktop の設定ファイルに追加します：

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

グローバルインストール経由

npm install -g bcb-br-mcp

{
  "mcpServers": {
    "bcb-br": {
      "command": "bcb-br-mcp"
    }
  }
}

ChatGPT（Deep Research）

ChatGPT の Deep Research（企業ナレッジおよび Responses API を使用したリサーチワークフローも含む）で使用できるのは、search と fetch のみを公開する MCP サーバーです。このサーバーは bcb_* ツールに加えて、それらも公開しています。ホストされたエンドポイントをコネクターに指定してください。キーは不要です：

https://bcb.sidneybissoli.com/mcp

search は時系列カタログ（厳選された 135 件の時系列と、Open Data Portal からインデックス化された数千件）に対してクエリをランク付けし、{ id, title, url } を返します（ID は sgs:<code> です）。fetch は、正規の公開 URL とともに、時系列を読みやすい Markdown（名前、カテゴリー、頻度、単位、最新値）で返します。ChatGPT が引用するのはこの URL です。時系列にページがある場合は dadosabertos.bcb.gov.br のデータセットページ、ない場合は最新の観測値を取得する公開 SGS クエリになります（SGS には時系列ごとのページがありません）。どちらも、他のすべてのツールと同じ出典情報ブロックを含みます。ChatGPT の開発者モード（Settings → Security and login → Developer mode）では、どのツールでも呼び出せますが、データの取得には引き続き bcb_* ツールを使用してください。

使用例

現在の Selic 金利を取得する

What is the current Selic interest rate?
→ Uses bcb_indicadores_atuais

2024 年の IPCA の履歴

Show me the monthly IPCA for 2024
→ Uses bcb_serie_valores with code 433, dataInicial 2024-01-01, dataFinal 2024-12-31

インフレ指標を一覧表示する

What inflation series are available?
→ Uses bcb_series_populares with category "Inflação"

USD 為替レートの時系列を検索する

Search for series related to the dollar
→ Uses bcb_buscar_serie with term "dolar" (works without accents)

USD/BRL の変動を計算する

What was the USD/BRL variation over the last 12 months?
→ Uses bcb_variacao with code 1 and periodos 12

IPCA、IGP-M、INPC を比較する

Compare IPCA, IGP-M, and INPC in 2024
→ Uses bcb_comparar with codes [433, 189, 188], dataInicial 2024-01-01, dataFinal 2024-12-31

時系列カタログ（135 件）

厳選されたカタログには、2026-08-13 に各データソースと照合して検証済みの 135 件の時系列が含まれます（廃止された FGV の時系列 4 件は 2026-08-23 に削除されました）。

各エントリーの fonteNome フィールドには、名前の出典が記載されています：

portal（82 件）— 名前は BCB Open Data Portal の時系列データセットから転記されており、unidade には公開されている測定単位が記載されています。
medido（53 件）— 時系列にポータル上のデータセットがないため、名前は継承されています。ソースと照合して検証されたのは、周期性と桁数です。

周期性は常に実測値（観測間隔から算出）であり、継承されたラベルではありません。市場予想はここにはありません。bcb_focus_expectativas を使用してください。

金利（14）

コード	名称	頻度	名称の出典
11	金利 - Selic	日次	`portal`
432	金利 - Copom が定める Selic 目標金利	日次	`portal`
1178	金利 - Selic 年率換算、252日基準	日次	`portal`
4189	金利 - 月間累積 Selic の年率換算、252日基準	月次	`portal`
4390	金利 - 月間累積 Selic	月次	`portal`
12	金利 - CDI 日次	日次	`medido`
4389	金利 - CDI 年率換算、252日基準	日次	`medido`
4391	金利 - 月間累積 CDI	月次	`medido`
4392	金利 - 月間累積 CDI の年率換算	月次	`medido`
226	参照金利（TR）- 日次	日次	`medido`
7811	参照金利（TR）- 月次	月次	`medido`
7812	参照金利（TR）- 年率換算	月次	`medido`
256	長期金利（TJLP）	月次	`medido`
253	金利 - 固定金利 CDB - 30日	日次	`medido`

インフレ（28）

コード	名称	頻度	名称の出典
433	IPCA - 月間変動率	月次	`medido`
13522	IPCA - 12か月累積変動率	月次	`medido`
7478	IPCA-15 - 月間変動率	月次	`medido`
10764	IPCA-E - 月間変動率	月次	`medido`
16121	全国消費者物価指数 - 総合（IPCA）- 除外方式コア - ex2	月次	`portal`
16122	全国消費者物価指数 - 総合（IPCA）- 二重加重コア	月次	`portal`
11426	全国消費者物価指数 - 総合（IPCA）- 平滑化なし刈り込み平均コア	月次	`portal`
11427	全国消費者物価指数 - 総合（IPCA）- 除外方式コア - 管理価格および家庭内食品を除く	月次	`portal`
10841	総合消費者物価指数（IPCA）- 非耐久財	月次	`portal`
10842	総合消費者物価指数（IPCA）- 半耐久財	月次	`portal`
10843	総合消費者物価指数（IPCA）- 耐久財	月次	`portal`
10844	総合消費者物価指数（IPCA）- サービス	月次	`portal`
4449	全国総合消費者物価指数（IPCA）- 管理価格 - 合計	月次	`portal`
11428	全国消費者物価指数 - 総合（IPCA）- 自由価格品目	月次	`portal`
188	INPC - 月間変動率	月次	`medido`
189	IGP-M - 月間変動率	月次	`medido`
7447	IGP-10 - 月間変動率	月次	`medido`
7448	IGP-M - 第1速報値	月次	`medido`
7449	IGP-M - 第2速報値	月次	`medido`
190	IGP-DI - 月間変動率	月次	`medido`
7450	IPA-M - 月間変動率	月次	`medido`
225	IPA-DI - 総合 - 月間変動率	月次	`medido`
7459	IPA-DI - 工業製品	月次	`medido`
7460	IPA-DI - 農産物	月次	`medido`
191	IPC-DI - 月間変動率	月次	`medido`
193	IPC-Fipe - 月間変動率	月次	`medido`
17679	IPC-3i - 月間変動率	月次	`medido`
17680	IPC-C1 - 月間変動率	月次	`medido`

為替（13）

コード	名称	頻度	名称の出典
1	為替レート - 自由市場 - 米ドル（売値） - 日次	日次	`portal`
10813	為替レート - 自由市場 - 米ドル（買値）	日次	`portal`
3698	為替レート - PTAX - 米ドル（売値）	月次	`medido`
3697	為替レート - PTAX - 米ドル（買値）	月次	`medido`
3695	為替レート - PTAX - 米ドル（平均）	月次	`medido`
21619	為替レート - ユーロ（売値）	日次	`medido`
21620	為替レート - ユーロ（買値）	日次	`medido`
21623	為替レート - 英ポンド（売値）	日次	`medido`
21624	為替レート - 英ポンド（買値）	日次	`medido`
21621	為替レート - 円（売値）	日次	`medido`
21622	為替レート - 円（買値）	日次	`medido`
21625	為替レート - スイスフラン（売値）	日次	`medido`
21626	為替レート - スイスフラン（買値）	日次	`medido`

経済活動（21）

コード	名称	頻度	名称の出典
4380	月次 GDP - 名目値（百万レアル）	月次	`medido`
4381	年初来累計 GDP - 名目値（百万レアル）	月次	`medido`
4382	直近12か月累計 GDP - 名目値（百万レアル）	月次	`medido`
4385	米ドル建て月次 GDP（百万）	月次	`medido`
4386	米ドル建て年初来累計 GDP（百万）	月次	`medido`
7324	米ドル建て年間 GDP（百万）	年次	`medido`
24363	中央銀行経済活動指数 - IBC-Br	月次	`portal`
24364	中央銀行経済活動指数（IBC-Br） - 季節調整済み	月次	`portal`
29601	中央銀行経済活動指数（IBC-Br）農業・畜産業	月次	`portal`
29602	中央銀行経済活動指数（IBC-Br）農業・畜産業 - 季節調整済み	月次	`portal`
29603	中央銀行経済活動指数（IBC-Br）工業	月次	`portal`
29604	中央銀行経済活動指数（IBC-Br）工業 - 季節調整済み	月次	`portal`
29605	中央銀行経済活動指数（IBC-Br）サービス	月次	`portal`
29606	中央銀行経済活動指数（IBC-Br）サービス - 季節調整済み	月次	`portal`
22103	財・サービスの輸出 - 四半期	四半期	`medido`
22104	財・サービスの輸入 - 四半期	四半期	`medido`
22109	家計消費 - 四半期	四半期	`medido`
22110	政府消費 - 四半期	四半期	`medido`
22111	総固定資本形成 - 四半期	四半期	`medido`
21859	工業生産 - 全体 - 月次変化率	月次	`medido`
21862	設備稼働率 - 工業	月次	`medido`

雇用（4）

コード	名称	頻度	名称の出典
24369	失業率 - PNAD Contínua	月次	`medido`
24380	実質平均通常所得 - 全就業	月次	`medido`
24381	実質通常所得総額	月次	`medido`
28561	CAGED - 正式雇用の純増数	月次	`medido`

財政（7）

Code	Name	Periodicity	Name source
4503	公的部門純債務（対GDP比）- 合計 - 連邦政府および中央銀行	月次	`portal`
4513	公的部門純債務（対GDP比）- 合計 - 連結公的部門	月次	`portal`
4505	公的部門純債務（対GDP比）- 合計 - 中央銀行	月次	`portal`
4536	一般政府純債務（対GDP比）	月次	`portal`
4537	一般政府総債務（対GDP比）- 2007年まで使用されていた方法	月次	`portal`
5364	中央政府の総収入	月次	`medido`
5793	為替切り下げを除くNFSP（対GDP比）- 12か月累計フロー - 基礎的収支 - 合計 - 連結公的部門	月次	`portal`

対外部門（12）

Code	Name	Periodicity	Name source
3546	外貨準備 - 流動性ベース - 合計	月次	`medido`
13621	外貨準備 - 現金ベース - 合計 - 日次	日次	`portal`
22707	貿易収支 - 国際収支 - 月次 - 収支	月次	`portal`
22708	財貨輸出 - 国際収支 - 月次	月次	`portal`
22709	財貨輸入 - 国際収支 - 月次	月次	`portal`
22714	マーチャンティングによる輸出財 - 輸出（プラス）- 月次	月次	`portal`
22701	経常取引 - 月次 - 収支	月次	`portal`
22704	貿易収支およびサービス - 月次 - 収支	月次	`portal`
22715	マーチャンティングによる輸入財 - 輸出（マイナス）- 月次	月次	`portal`
22716	貿易収支 - 非貨幣用金 - 国際収支 - 月次 - 収支	月次	`portal`
22846	第2次所得 - その他部門 - 個人移転 - 月次 - 受取	月次	`portal`
22885	国内直接投資 - IDP - 月次 - 純額	月次	`portal`

信用（30）

コード	名前	周期	名前の出典
20539	信用ポートフォリオ残高 - 合計	月次	`portal`
20540	信用ポートフォリオ残高 - 法人 - 合計	月次	`portal`
20541	信用ポートフォリオ残高 - 個人 - 合計	月次	`portal`
20542	自由資金による信用ポートフォリオ残高 - 合計	月次	`portal`
20570	自由資金による信用ポートフォリオ残高 - 個人 - 合計	月次	`portal`
20592	自由資金による信用ポートフォリオ残高 - 個人 - その他の自由信用	月次	`portal`
20615	指定資金による信用ポートフォリオ残高 - 個人 - BNDES 資金による農産業融資	月次	`portal`
20631	信用供与額 - 合計	月次	`portal`
20665	自由資金による信用供与額 - 個人 - 当座貸越	月次	`portal`
20714	信用取引の平均金利 - 合計	月次	`portal`
20716	信用取引の平均金利 - 個人 - 合計	月次	`portal`
20740	自由資金による信用取引の平均金利 - 個人 - 合計	月次	`portal`
20749	自由資金による信用取引の平均金利 - 個人 - 車両購入	月次	`portal`
20772	指定資金による信用取引の平均金利 - 個人 - 市場金利による不動産融資	月次	`portal`
25497	指定資金による信用取引の月平均金利 - 個人 - 市場金利による不動産融資	月次	`portal`
20783	信用取引の平均スプレッド - 合計	月次	`portal`
20785	信用取引の平均スプレッド - 個人 - 合計	月次	`portal`
20786	自由資金による信用取引の平均スプレッド - 合計	月次	`portal`
21082	信用ポートフォリオの延滞率 - 合計	月次	`portal`
21084	信用ポートフォリオの延滞率 - 個人 - 合計	月次	`portal`
21085	自由資金による信用ポートフォリオの延滞率 - 合計	月次	`portal`
21128	自由資金による信用ポートフォリオの延滞率 - 個人 - 分割払いクレジットカード	月次	`portal`
21129	自由資金による信用ポートフォリオの延滞率 - 個人 - クレジットカード合計	月次	`portal`
13685	民間管理下の金融機関の信用ポートフォリオの延滞率 - 合計	月次	`portal`
29033	家計の国立金融システムに対する債務の利息負担率 - 季節調整済み（RNDBF）	月次	`portal`
29034	家計の国立金融システムに対する債務返済負担率 - 季節調整済み（RNDBF）	月次	`portal`
29035	住宅ローンを除く、家計の国立金融システムに対する債務返済負担率 - 季節調整済み（RNDBF）	月次	`portal`
29036	家計の国立金融システムに対する債務の元本返済負担率 - 季節調整済み（RNDBF）	月次	`portal`
29037	過去12か月の累積所得に対する家計の国立金融システムへの債務比率（RNDBF）	月次	`portal`
29038	過去12か月の累積所得に対する、住宅ローンを除く家計の国立金融システムへの債務比率（RNDBF）	月次	`portal`

金融集計量（8）

Code	Name	Periodicity	Name source
1788	BM - 制限的貨幣ベース（期間末残高）	月次	`portal`
1833	拡大貨幣ベース（期間末残高）	月次	`portal`
27788	支払手段 - M1（月の営業日平均）- 新	月次	`portal`
27789	支払手段 - 民間保有紙幣（期間末残高）- 新	月次	`portal`
27790	支払手段 - 要求払預金（期間末残高）- 新	月次	`portal`
27791	支払手段 - M1（期間末残高）- 新	月次	`portal`
27815	広義の支払手段 - M4（期間末残高）- 新	月次	`portal`
7530	貨幣行動 - 民間の行動 - C	月次	`portal`

貯蓄（2）

Code	Name	Periodicity	Name source
25	2012年5月3日までの貯蓄預金 - 期間中の収益率	日次	`portal`
195	2012年5月4日以降の貯蓄預金 - 期間中の収益率	日次	`portal`

完全な機械可読カタログは、bcb://series/populares リソースおよび bcb_series_populares で提供されています。さらに数千の系列は bcb_buscar_serie から検索でき、 BCB オープンデータポータルのインデックスも照会します。

その他の系列を探す

SGS データベースには、18,000 を超える時系列データがあります。その他の系列のコードを見つけるには、次の手順に従ってください。

BCB SGS ポータルにアクセスします
希望する系列を検索します
系列コードを確認します
このサーバーのツールでそのコードを使用します

BCB の言い方ではなく、自分の言葉で尋ねる

bcb_buscar_serie は、キュレーション済みカタログ（系列名とカテゴリからなる135系列）と、BCB オープンデータポータルのデータセットスラッグ（コードで識別される3,579系列）に対して、入力したすべての語句を AND 条件で照合します。アクセントはすでに無視されていましたが、語句自体は無視されていませんでした。2026-09-16 に両レイヤーで測定され、1.12.0 以降固定されています。日常的な語句は BCB 独自の語句に展開され、応答では notasVocabulario でその旨が示されます。検索結果がゼロの場合は、別の方法も案内されます。

入力した語句	変更前のヒット数（キュレーション済み / ポータル）	BCB での表記	ヒット数
`déficit`、`superávit`	0 / 0	基礎的財政収支、名目財政収支	1 / 26、0 / 22
`calote`	0 / 0	債務不履行	6 / 484
`juros básicos`	0 / 0	Selic	5 / 7
`desemprego`	0 / 0	失業	1 / 0
`arrecadação`、`gasto`	0 / 0	歳入、歳出	2 / 8、0 / 8
`investimento estrangeiro`	0 / 0	直接投資	1 / 12
`conta corrente`	0 / 0	経常取引	1 / 5

表には実測された組み合わせのみを記載しています（src/vocabulario.ts）。入力語句が両方のレイヤーに存在せず、BCB の語句が存在する組み合わせです。BCB がこれらの名称のいずれでも公開していないものは対象外となり、検索結果は引き続きゼロです。たとえば、salário mínimo、ibovespa、bitcoin、meta de inflação が該当します。存在しない系列の別名を用意すると、情報源にないものがあるかのように約束してしまうためです。また、empréstimo を意図的に crédito に対応付けていません（ポータルではすでに45件のデータセットが返されており、対応付けると2,000件に埋もれてしまいます）。同じ表が Deep Research の search インデックスにも使用されます。

技術詳細

堅牢性

タイムアウト：リクエストごとに30秒（応答停止を防止）
自動再試行：一時的な障害では、指数バックオフ（1秒、2秒、4秒）で3回試行します。クライアントエラー（4xx）は確定的なため、再試行しません
エラー処理：明確なエラーメッセージ

SGS の制限への対処

ドキュメントからの推測ではなく、稼働中の API で確認した内容です。

日次系列で期間が 10 年を超える場合は HTTP 406 で拒否されます。また、開始日なし（dataInicial なし、または日付指定なし）の期間も拒否されます。この制限は暗黙の期間にも適用されます。dataFinal を指定しない場合、API は今日を終点とします。リクエストは最大 3 年の期間に分割し、同時実行数を制限して取得した後、境界で重複させずに日付順で統合します。レスポンスの chunking に分割情報が記載されます。許容される 10 年ではなく 3 年で分割するのは、日次データの 10 年分の取得に上流で 10～20 秒かかり、約 30 秒でタイムアウトする可能性があるためです。
**dados/ultimos/N は、周期を問わず API により 20 件までに制限されています。**20 件を超える場合、サーバーは系列の周期を推定し、日付範囲で取得します。
系列ごとのメタデータエンドポイントはありません（/metadados は 404 を返します）。観測値の間隔から頻度を推定し、periodicidadeInferida で示します。測定単位はどの情報源からも取得できません。

派生値

このサーバーが計算する値（変動率、記述統計、調和系列など）には derived: true が付き、使用した規約を記した注記が含まれます。統計値は @sbissoli/mcp-stats に基づいています。BCB が公表した値は常にそのまま返されます。丸め処理は計算値にのみ適用されます（小数点以下 4 桁）。

スマート検索

bcb_buscar_serie は 2 つのレイヤーを検索します。検証済みの 135 系列をまとめた厳選カタログ（最初に検索され、名称の出典も明記）と、コードで識別された数千系列を含む BCB Open Data Portal のインデックスです。検索語はアクセントと大文字・小文字を区別せず、複数の語は AND 条件で組み合わせられます。

"inflacao" → 「Inflação」が見つかります
"cambio" → 「Câmbio」が見つかります
"ipca servicos" → 両方の語が一致する必要があります

ポータルのインデックスは 24 時間キャッシュされ、有効期限後の最初の検索時に更新されます（ポータルへのリクエストは 1 回のみで、系列コードと名称などのメタデータのみを取得し、観測値は取得しません）。すべての回答に catalogo.cobertura が含まれます。このインデックスは SGS 全体を網羅しているわけではないため、ここで系列が見つからなくても、その系列が存在しない証拠にはなりません。

データソースとライセンス

Banco Central do Brasil（SGS / Olinda-Expectativas / PTAX）から取得したデータは、Open Data Commons Open Database License (ODbL) v1.0（https://opendatacommons.org/licenses/odbl/1-0/）のもとで公開されています。2026-08-13 に情報源と照合して再確認したところ、ポータルの 4,260 データセットのうち 4,259 件で license_id: "odc-odbl" が宣言されています。これは CC0、CC BY、またはパブリックドメインではありません。ODbL には、帰属表示、継承（派生データベースに適用）、および DRM に関する制限条項があります。為替レートに関する回答には、BCB 自身の免責事項がそのまま含まれます。通貨間の交換比率は BCB が作成したものではありません。情報機関（Refinitiv）から提供され、BCB が再配布しているものであり、ツールでもその旨を明記しています。

サーバー自体のコードは MIT ライセンスですが、データはそうではありません。NOTICE.md を参照してください。プライバシーについては、どちらの経路でもユーザーデータは記録されません。PRIVACY.md を参照してください。

Provenance ブロック

成功したすべてのツール応答には、2 つのチャネルに provenance ブロック（ポートフォリオ契約 v1.0）が含まれます。 structuredContent.provenance と attribution（モデルに表示）に加え、br.com.sidneybissoli.bcb/* 配下に _meta のミラー（帯域外、トークン消費ゼロ）が含まれます。各ブロックには、ソース、クエリを再現する正規 URL、データのビンテージ、実際の上流データ抽出時刻、ライセンスが記載されます。

間違えやすい次の 3 点には、ここで対応しています。

retrieved_at は「現在」ではなく、実際にデータを抽出した時刻です。 ポータルのインデックスは 24 時間キャッシュから配信されるため、キャッシュを使って回答した検索では、インデックスが実際に取得された時刻が報告されます。1 日前のこともあり、法的に関連する日付です。
provenance ごとにブロックを 1 つずつ設け、決して統合しません。 bcb_buscar_serie では、BCB ポータルのインデックスとサーバー独自のキュレーション済みカタログを分けます。bcb_serie_metadados では、SGS の最新の読み取り値とカタログを分けます。bcb_cambio_cotacao では、BCB が集計したドルレートと、機関が提供する通貨間のパリティを分けます。
各数値の意味と、どのバージョンなのかを明確にします。 SGS の観測値は {data, valor} のみです。月次、四半期、年次の系列の日付は、参照期間の初日です。また、系列の中には、すでに累計値になっているもの（年初来 GDP 4381/4386、12 か月 IPCA 13522、GDP 4382、基礎的財政収支 5793）もあり、その意味は系列名からしか分かりません。ツールの説明にその旨が記載され、data_vintage には、複数の系列をまたいで計算する 4 つのツールも含め、実際に対象となった期間が示されます。すべての値は、retrieved_at 時点で SGS が公開しているバージョンです。BCB は GDP や IBC-Br などの系列を改定し、SGS は初回公開時のコピーを保持しないため、このサーバーからそのバージョンを返すことはできません。

開発

サーフェスフィンガープリント（レジストリで検証可能）

各リリースでは、MCP Registry のエントリに、このバージョンが提供するサーフェス（initialize、ツール、リソース、プロンプト）の sha256 と、認証情報なしで応答するメソッドが公開されます。バージョンを上げずにサーフェスを変更するとビルドに失敗します。レジストリのフィンガープリントを使えば、クライアント側でも同じ内容を確認できます。正規形式と手順については、@sbissoli/mcp-surface の SPEC.md を参照してください。自分で確認する場合（Node 18 以降、依存関係なし）：

curl -sO https://raw.githubusercontent.com/SidneyBissoli/mcp-br-commons/main/packages/mcp-surface/exemplos/verify.mjs
node verify.mjs io.github.SidneyBissoli/bcb-br-mcp

要件

Node.js >= 18.0.0

セットアップ

git clone https://github.com/SidneyBissoli/bcb-br-mcp.git
cd bcb-br-mcp
npm install

ビルド

npm run build

ローカルテスト（stdio）

npm run dev

ローカルテスト（HTTP worker）

npm run dev:worker

または、MCP Inspector を使用します。

npx @modelcontextprotocol/inspector npm run dev

BCB API

このサーバーは、ブラジル中央銀行の公開 API を使用します。

ベースエンドポイント： https://api.bcb.gov.br/dados/serie/bcdata.sgs.{code}/dados
形式： JSON
認証： 不要（公開 API）
ドキュメント： BCB Open Data

変更履歴

v1.4.1

bcb_focus_referencias：パラメーターは horizonte ではなく escopo になり、レスポンス配列は escopos になりました。スコープは bcb_focus_expectativas の 5 つの期間 に selic を加えたものです。selic は期間ではなく、軸は Copom の会合です。各ブロックには、それを使用する tool が記載されます。以前の名前では、selic が bcb_focus_expectativas でクエリ可能な期間であるかのように誤解を招いていましたが、実際はそうではありません。以前の名前では npm に公開されていません。

v1.4.0

1つの契約で3つのAPI、ツール数は8から13に。 市場予想調査（bcb_focus_expectativas、bcb_focus_selic、bcb_focus_referencias）とPTAX為替レート（bcb_cambio_cotacao、bcb_cambio_moedas）に対応し、ソースにある約18個のODataリソースをそのまま模倣するのではなく、パラメーターごとに集約しています。
実際の検索に対応。 bcb_buscar_serie は厳選されたカタログに加え、Open Data Portalのインデックス（3,500以上の系列、24時間キャッシュ、メタデータのみ）も検索するようになりました。また、系列が存在しないと断定せず、インデックスの収録範囲を示します。
FocusとPTAXのすべてのフィールド名を実際のAPIで検証しました。これには、他の12個とは大文字・小文字の表記が異なるフィールドを公開しているTop 5 Selicリソースも含まれます。
為替レートツールにはODbLの義務に関する情報を同梱しています。BCBの免責事項は一字一句そのまま渡し、米ドル以外の通貨ペアはBCBが再配布する第三者（Refinitiv）のデータであると明記しています。

v1.2.0

Cloudflare Workers経由のHTTPエンドポイント（https://bcb.sidneybissoli.workers.dev）
Smithery.aiで公開
リファクタリング：ツールのロジックをsrc/tools.tsに切り出し（stdioとHTTPで共有）

v1.1.0

パーセンテージ変化を計算する新しいツールbcb_variacao
複数の系列を比較する新しいツールbcb_comparar
リクエストに30秒のタイムアウトを設定
指数バックオフによる自動再試行（3回）
正規化検索（アクセント記号を区別しない）
追加の統計情報（最大値、最小値、平均値、範囲）

v1.0.0

初回リリース
基本ツール6個
検証済み系列135件を収録したカタログ

貢献

貢献を歓迎します！以下の手順でお願いします。

リポジトリをフォークします
機能ブランチを作成します（git checkout -b feature/new-feature）
変更をコミットします（git commit -m 'Add new feature'）
ブランチにプッシュします（git push origin feature/new-feature）
Pull Requestを作成します

ライセンス

ライセンスは2種類あり、同じものではありません。

コード： MIT — LICENSEをご覧ください。
データ： Banco Central do Brasilのデータは、Open Data Commons Open Database License (ODbL) v1.0に基づきます — https://opendatacommons.org/licenses/odbl/1-0/。 CC0でもCC BYでもパブリックドメインでもありません。ODbLには、帰属表示、派生データベースに対する継承条項、およびDRM禁止条項があります。

すべての成功応答には、データソース、クエリURL、データの時点、実際の抽出日時、ライセンスを記載した出所情報ブロックが含まれます。為替レートに関する回答では、BCBの免責事項を一字一句そのまま渡し、米ドル以外の通貨ペアについては、中央銀行が作成したデータではなく、情報機関（Refinitiv）のデータをBCBが再配布しているものと明記します。

詳細と義務についてはNOTICE.mdをご覧ください。プライバシー：どちらの通信方式でもユーザーデータは記録されません。PRIVACY.mdをご覧ください。

作者

Sidney da Silva Pereira Bissoli

GitHub：@SidneyBissoli
メール：[email protected]

便利なリンク

Markdown 対応

ログインしてコメント

基本情報

作者: SidneyBissoli
言語: node
バージョン: 1.19.0
トランスポート: stdio · streamable-http
掲載日: 2026年3月18日
最終更新: 1 日前
公式 Registry: io.github.SidneyBissoli/bcb-br-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。