Bcrp MCP

🚀 BCRP-MCP

BCRP-MCPは、ペルー中央準備銀行（BCRP: Banco Central de Reserva del Perú）の経済および金融時系列データに対する、Model Context Protocol (MCP) サーバーです。このサーバーを通じて、AIエージェントやアプリケーションは、標準化されたMCPインターフェースを介して、ペルーの経済指標、金融統計、通貨データを検索、探索、分析することができます。

🚀 クイックスタート

BCRP-MCPを使用することで、ペルーの経済および金融時系列データにアクセスできます。以下のセクションでは、使い方やツールの詳細を説明します。

✨ 主な機能

• データアクセス: BCRPの経済および金融時系列データに対するシームレスなアクセスを提供します。
• 標準化インターフェース: AIエージェントやアプリケーションが、標準化されたMCPインターフェースを通じてデータを検索、探索、分析できます。

📦 インストール

Claude Desktop (リモートサーバー)

⚠️ 重要提示

npx が必要です。npx はnpmに同梱されています。npmがインストールされていない場合は、npmを含むNode.jsをインストールしてください。

Claude Desktopの設定（Claude > 設定 > 開発者 > 設定を編集）に以下を追加します。

{
  "mcpServers": {
    "bcrp_mcp_remote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://bcrp-mcp.onrender.com/mcp"
      ]
    }
  }
}

ローカルサーバー

⚠️ 重要提示

uv がインストールされていることを確認してください。インストールされていない場合は、uv.tool からインストールしてください。

以下のコマンドを実行してクローンとインストールを行います。

git clone https://github.com/rodcar/bcrp-mcp.git
cd bcrp-mcp
uv sync

Claude Desktopの設定（Claude > 設定 > 開発者 > 設定を編集）に以下を追加します。

⚠️ 重要提示

/path/to/bcrp-mcp を、実際にリポジトリをクローンしたパスに置き換えてください。

{
  "mcpServers": {
    "simple_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/bcrp-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

MCPインスペクター（代替手段）

⚠️ 重要提示

npx が必要です。npx はnpmに同梱されています。npmがインストールされていない場合は、npmを含むNode.jsをインストールしてください。

⚠️ 重要提示

/path/to/bcrp-mcp を、実際にリポジトリをクローンしたパスに置き換えてください。

以下のコマンドを実行します。

npx @modelcontextprotocol/inspector \
  uv \
  --directory /path/to/bcrp-mcp \                     
  run \
  main.py

MCPインスペクターを開き（コンソールに表示されるURL）、以下の設定でMCPクライアントを構成します。

• トランスポートタイプ: Streamable HTTP
• URL: http://bcrp-mcp.onrender.com/mcp
• リクエストタイムアウト: デフォルト値から増やす
• 最大合計タイムアウト: デフォルト値から増やす
• プロキシセッショントークン: コンソールで生成されたトークンを使用

💻 使用例

📚 ドキュメント

🔧 ツール

⚠️ 重要提示

リモートサーバーを使用する場合、MCPクライアントは接続タイムアウト設定を増やす必要がある場合があります。

💬 プロンプト

🏛️ 技術詳細

BCRP-MCPは、Model Context Protocol仕様に従っており、BCRP APIの上にクリーンな抽象化レイヤーを提供します。

graph LR
    CLIENT[MCP Client<br/>Claude Desktop, IDE, etc.] --> MCP_SERVER[BCRP-MCP Server]
    
    subgraph TOOLS ["🔧 ツール"]
        SEARCH_GROUP[search_time_serie_group]
        SEARCH_SERIES[search_time_series_by_group]
        GET_DATA[get_time_series_data]
    end
    
    subgraph "💬 プロンプト"
        SEARCH_PROMPT[search_data]
        ASK_PROMPT[ask]
    end
    
    MCP_SERVER --> SEARCH_GROUP
    MCP_SERVER --> SEARCH_SERIES
    MCP_SERVER --> GET_DATA
    MCP_SERVER --> SEARCH_PROMPT
    MCP_SERVER --> ASK_PROMPT
    
    TOOLS --> BCRP_API[BCRP API<br/>estadisticas.bcrp.gob.pe]
    
    style CLIENT fill:#e3f2fd
    style MCP_SERVER fill:#f3e5f5
    style BCRP_API fill:#fff3e0

📄 ライセンス

このプロジェクトは、Apache License 2.0の下でライセンスされています。

🙏 謝辞

• BCRP がペルーの経済データをオープンアクセスで提供してくれたことに感謝します。
• bcrpy ライブラリ（https://github.com/andrewrgarcia/bcrpy）が、BCRPデータのPythonインターフェースを提供してくれたことに感謝します。

⚠️ 重要提示

bcrpyは初期開発で使用されていましたが、現在は依存関係ではありません。残念ながら、リモートMCPサーバーのパフォーマンスが低く、レスポンスタイムアウトの原因となっていました。

👨‍💻 作者

Ivan Yang Rodriguez Carranza

🎬 デモ

デモ（スペイン語）: https://youtube.com/shorts/gsjC07WR0n0