Bcb Br MCP

🚀 BCB BR MCP Server

このサーバーは、ブラジル中央銀行（SGS/BCB）の時系列データにアクセスするためのMCP（Model Context Protocol）サーバーです。Selic、IPCA、為替レート、GDPなどの経済および金融指標を、ClaudeなどのAIアシスタントから直接照会することができます。

🚀 クイックスタート

このサーバーを使用することで、ブラジル中央銀行の時系列データにアクセスし、経済および金融指標を照会することができます。以下のセクションでは、機能、インストール方法、使用例などについて説明します。

✨ 主な機能

• 履歴データの照会 - コードと日付フィルターを使用して、時系列データの値を検索します。
• 最新の値 - 時系列データの最新のN個の値を取得します。
• メタデータ - 時系列データに関する詳細情報（周期、情報源など）を提供します。
• 人気のある時系列データのカタログ - 12のカテゴリに分類された150以上の経済指標のリストです。
• スマート検索 - 検索用語（アクセントの有無を問わない）で時系列データを検索します。
• 現在の指標 - 主要な経済指標の最新の値を提供します。
• 変動率の計算 - 期間間のパーセント変動と統計情報を計算します。
• 時系列データの比較 - 同じ期間内の複数の時系列データを比較します。

📦 インストール

Claude Desktop

Claude Desktopの設定ファイルに以下の内容を追加してください。

Windows: %APPDATA%\Claude\claude_desktop_config.json

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

オプション1: npxを使用する（推奨）

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

オプション2: グローバルインストール

npm install -g bcb-br-mcp

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

💻 使用例

現在のSelic金利を照会する

現在のSelic金利はいくらですか？
→ bcb_indicadores_atuaisを使用

2024年のIPCAの履歴を表示する

2024年の月次IPCAを表示してください
→ コード433、開始日2024-01-01、終了日2024-12-31でbcb_serie_valoresを使用

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

利用可能なインフレ指標の時系列データはどれですか？
→ カテゴリ「インフレ」でbcb_series_popularesを使用

ドルに関連する時系列データを検索する

ドルに関連する時系列データを検索してください
→ 用語「dolar」（アクセントの有無を問わない）でbcb_buscar_serieを使用

ドルの変動率を計算する

過去12か月間のドルの変動率はいくらですか？
→ コード1と期間12でbcb_variacaoを使用

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

2024年のIPCA、IGP-M、INPCを比較してください
→ コード[433, 189, 188]、開始日2024-01-01、終了日2024-12-31でbcb_compararを使用

📚 詳細ドキュメント

時系列データのカタログ（150以上）

サーバーには、12のカテゴリに分類された150以上の時系列データが含まれています。

金利と利率

インフレ（30以上の時系列データ）

為替（15以上の時系列データ）

経済活動（25以上の時系列データ）

雇用（10以上の時系列データ）

財政（10以上の時系列データ）

対外セクター（15以上の時系列データ）

信用（30以上の時系列データ）

通貨統計

貯蓄

市場指数

予測（Focus）

他の時系列データを見つける

SGSには18,000以上の時系列データがあります。他の時系列データのコードを見つけるには、以下の手順を実行してください。

1. BCBのSGSポータルにアクセスします。
2. 検索機能を使用して、目的の時系列データを見つけます。
3. 時系列データのコードをメモします。
4. このコードをこのサーバーのツールで使用します。

🔧 技術詳細

堅牢性

• タイムアウト: リクエストごとに30秒（凍結を回避）
• 自動リトライ: 指数関数的バックオフ（1秒、2秒、4秒）で3回の試行
• エラー処理: ポルトガル語で明確なメッセージ

スマート検索

bcb_buscar_serieツールは、検索用語を正規化し、アクセントのない用語でも時系列データを見つけることができます。

• "inflacao" → "インフレ"を見つける
• "cambio" → "為替"を見つける
• "credito" → "信用"を見つける

🚧 開発

要件

• Node.js >= 18.0.0

セットアップ

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

ビルド

npm run build

ローカルテスト

npm run dev

または、MCPインスペクターを使用します。

npx @modelcontextprotocol/inspector npm run dev

📄 API情報

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

• ベースエンドポイント: https://api.bcb.gov.br/dados/serie/bcdata.sgs.{codigo}/dados
• 形式: JSON
• 認証: なし（公開API）
• ドキュメント: BCBのオープンデータ

📝 更新履歴

v1.1.0

• ✨ パーセント変動率を計算するための新しいツールbcb_variacaoを追加
• ✨ 複数の時系列データを比較するための新しいツールbcb_compararを追加
• 🔧 リクエストのタイムアウトを30秒に設定
• 🔧 指数関数的バックオフで自動リトライ（3回の試行）
• 🔧 正規化された検索（アクセントのない用語を受け入れる）
• 📊 追加の統計情報（最大値、最小値、平均値、振幅）

v1.0.0

• 🎉 初期リリース
• 6つの基本ツール
• 150以上の時系列データのカタログ

🤝 コントリビューション

コントリビューションは大歓迎です！以下の手順に従ってください。

1. リポジトリをフォークします。
2. 新しい機能のブランチを作成します (git checkout -b feature/nova-feature)。
3. 変更をコミットします (git commit -m '新しい機能を追加')。
4. ブランチにプッシュします (git push origin feature/nova-feature)。
5. プルリクエストを作成します。

📄 ライセンス

MIT - 詳細についてはLICENSEを参照してください。

👨‍💻 作者

Sidney Bissoli

• GitHub: @SidneyBissoli
• Email: sbissoli76@gmail.com

🔗 有用なリンク

• BCBのSGSポータル
• BCBのオープンデータ
• Model Context Protocol
• MCP Registry
• npm: bcb-br-mcp