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客户端。

💻 使用示例

基础用法

通过不同的工具和提示词进行操作，例如：

工具使用

| 名称 | 输入 | 描述 | |------|-------|-------------| | search_time_series_groups | keywords | 使用一个或多个关键字搜索时间序列组 | | search_time_series_by_group | time_series_group | 查找特定组内的所有时间序列，返回代码和名称对 | | get_time_series_data | time_series_code
start
end | 在指定日期范围内检索特定代码的时间序列数据 |

提示词使用

| 名称 | 输入 | 描述 | |------|-------|-------------| | search_data | keyword | 通过关键字搜索引导工作流程以查找相关时间序列 | | ask | question | 金融分析工作流程，提取关键字、搜索数据并回答问题 |

高级用法

在实际应用中，可以根据具体需求组合使用工具和提示词，例如使用 ask 提示词进行金融问题的分析： | 提示词 | 语言 | 问题 | 对话链接 | |--------|----------|----------|-------------| | ask | 西班牙语 | "¿Cómo ha evolucionado la tasa de interés de referencia en el último año?" | https://claude.ai/share/34df5f90-7a35-474d-b4cf-e8f48c3f9772 |

📚 详细文档

工具详情

| 名称 | 输入 | 描述 | |------|-------|-------------| | search_time_series_groups | keywords | 使用一个或多个关键字搜索时间序列组 | | search_time_series_by_group | time_series_group | 查找特定组内的所有时间序列，返回代码和名称对 | | get_time_series_data | time_series_code
start
end | 在指定日期范围内检索特定代码的时间序列数据 |

提示词详情

| 名称 | 输入 | 描述 | |------|-------|-------------| | search_data | keyword | 通过关键字搜索引导工作流程以查找相关时间序列 | | ask | question | 金融分析工作流程，提取关键字、搜索数据并回答问题 |

架构图

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服务器的性能导致了响应超时。