Bcrp MCP

🚀 BCRP-MCP

BCRP-MCP是一個模型上下文協議（MCP）服務器，它能讓用戶無縫訪問來自秘魯中央儲備銀行（BCRP） 的經濟和金融時間序列數據。通過標準化的MCP接口，該服務器使AI代理和應用程序能夠搜索、探索和分析秘魯的經濟指標、金融統計數據和貨幣數據。

🚀 快速開始

克勞德桌面版（遠程服務器）

⚠️ 重要提示

需要 npx，它隨npm一起提供。如果你沒有安裝npm，請安裝包含npm的 Node.js。

將以下內容添加到克勞德桌面版配置中（克勞德 > 設置 > 開發者 > 編輯配置）：

{
    "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

將以下內容添加到克勞德桌面版配置中（克勞德 > 設置 > 開發者 > 編輯配置）：

⚠️ 重要提示

將 /path/to/bcrp-mcp 替換為你克隆倉庫的實際路徑。

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

MCP檢查器（替代方案）

⚠️ 重要提示

需要 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客戶端：

• 傳輸類型：可流式傳輸的HTTP
• URL：http://bcrp-mcp.onrender.com/mcp
• 請求超時時間：從默認值增加
• 最大總超時時間：從默認值增加
• 代理會話令牌：使用控制檯中生成的令牌

✨ 主要特性

BCRP-MCP作為一個模型上下文協議（MCP）服務器，具有以下主要特性：

• 提供對秘魯中央儲備銀行經濟和金融時間序列數據的無縫訪問。
• 支持AI代理和應用程序通過標準化的MCP接口搜索、探索和分析秘魯經濟指標、金融統計數據和貨幣數據。

📦 安裝指南

克勞德桌面版（遠程服務器）

確保你已經安裝了 npx（隨npm一起提供），如果沒有安裝npm，請安裝 Node.js。然後將相應配置添加到克勞德桌面版配置中。

本地服務器

確保安裝了 uv（可從 uv.tool 安裝），克隆倉庫並執行 uv sync 命令，最後將配置添加到克勞德桌面版配置中。

MCP檢查器（替代方案）

確保安裝了 npx（隨npm一起提供），沒有安裝npm則安裝 Node.js，運行相應命令並按要求配置MCP客戶端。

💻 使用示例

基礎用法

通過不同的工具和提示詞進行操作，例如：

工具使用

提示詞使用

高級用法

在實際應用中，可以根據具體需求組合使用工具和提示詞，例如使用 ask 提示詞進行金融問題的分析：

📚 詳細文檔

工具詳情

提示詞詳情

架構圖

BCRP-MCP遵循模型上下文協議規範，並在BCRP API之上提供了一個清晰的抽象層。

graph LR
    CLIENT[MCP客戶端<br/>克勞德桌面版、IDE等] --> MCP_SERVER[BCRP-MCP服務器]
    
    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

🔧 技術細節

BCRP-MCP遵循模型上下文協議規範，在BCRP API之上提供了一個清晰的抽象層，使得AI代理和應用程序能夠通過標準化的MCP接口與BCRP的經濟和金融時間序列數據進行交互。

📄 許可證

本項目採用 Apache License 2.0 許可協議。

🙏 致謝

• BCRP 提供了秘魯經濟數據的開放訪問。
• bcrpy 庫提供了與BCRP數據的Python接口（https://github.com/andrewrgarcia/bcrpy）。

⚠️ 重要提示

bcrpy 在早期開發中使用過，現在不再是依賴項。不幸的是，遠程MCP服務器的性能導致了響應超時。