备份恢复管理控制台
项目介绍
BCRP-MCP
用于BCRP经济和金融时间序列数据的模型上下文协议（MCP）服务器
👨💻 作者
伊万·杨·罗德里格斯·卡尔干萨
📋 目录
🎯 概述
BCRP-MCP 是一个 模型上下文协议（MCP）服务器，它提供了对来自 BCRP（秘鲁中央储备银行） 的经济和金融时间序列数据的无缝访问。此服务器使AI代理和应用程序能够通过标准化的MCP接口搜索、探索和分析秘鲁的经济指标、金融统计数据和货币数据。
🎬 演示
<div align="center">https://github.com/user-attachments/assets/c42eb8c3-4a1c-442d-bd12-cc1fd4ff18ae
</div>演示（西班牙语）：https://youtube.com/shorts/gsjC07WR0n0
🔧 工具
| 名称 | 输入 | 描述 |
|---|---|---|
search_time_series_groups | 关键词 | 使用一个或多个关键词搜索时间序列组 |
search_time_series_by_group | 时间序列组 | 查找特定组内的所有时间序列，返回代码和名称对 |
get_time_series_data | 时间序列代码<br/>开始日期<br/>结束日期 | 获取特定代码在指定日期范围内的时间序列数据 |
注意： 当使用远程服务器时，MCP客户端可能需要增加连接超时设置。
💬 提示
| 名称 | 输入 | 描述 |
|---|---|---|
search_data | 关键词 | 使用关键词搜索相关时间序列的引导工作流程 |
ask | 问题 | 财务分析工作流程，提取关键词，搜索数据并回答问题 |
🚀 如何使用
Claude桌面（远程服务器）
注意： 需要
npx，它与npm捆绑在一起。如果你没有安装npm，请安装 Node.js，它包括npm。
添加到Claude桌面配置（Claude > 设置 > 开发者 > 编辑配置）：
{
"mcpServers": {
"bcrp_mcp_remote": {
"命令": "npx",
"参数": [
"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桌面配置（Claude > 设置 > 开发者 > 编辑配置）：
注意： 将
/path/to/bcrp-mcp替换为你实际克隆仓库的位置。
{
"mcpServers": {
"simple_mcp": {
"命令": "uv",
"参数": [
"--目录",
"/path/to/bcrp-mcp",
"运行",
"main.py"
]
}
}
}
MCP检查器（替代方案）
注意： 需要
npx，它与npm捆绑在一起。如果你没有安装npm，请安装 Node.js，它包括npm。
注意： 将
/path/to/bcrp-mcp替换为你实际克隆仓库的位置。
运行
npx @modelcontextprotocol/inspector \
uv \
--目录 /path/to/bcrp-mcp \
运行 \
main.py
打开MCP检查器（控制台显示的URL），并使用以下设置配置MCP客户端：
- 传输类型： 可流式传输HTTP
- URL：
http://bcrp-mcp.onrender.com/mcp - 请求超时： 增加默认值
- 最大总超时： 增加默认值
- 代理会话令牌： 使用控制台生成的令牌
💡 示例
| 提示 | 语言 | 问题 | 对话 |
|---|---|---|---|
ask | 西班牙语 | "过去一年参考利率是如何演变的？" | https://claude.ai/share/34df5f90-7a35-474d-b4cf-e8f48c3f9772 |
🏛️ 架构图
BCRP-MCP 遵循模型上下文协议规范，并在BCRP API之上提供了一个干净的抽象层。
graph LR
客户端[MCP客户端<br/>Claude桌面,IDE等] --> MCP服务器[BCRP-MCP服务器]
子图 工具 ["🔧 工具"]
搜索组[search_time_serie_group]
搜索系列[search_time_series_by_group]
获取数据[get_time_series_data]
end
子图 "💬 提示"
搜索提示[search_data]
询问提示[ask]
end
MCP服务器 --> 搜索组
MCP服务器 --> 搜索系列
MCP服务器 --> 获取数据
MCP服务器 --> 搜索提示
MCP服务器 --> 询问提示
工具 --> BCRP_API[BCRP API<br/>estadisticas.bcrp.gob.pe]
style 客户端 fill:#e3f2fd
style MCP服务器 fill:#f3e5f5
style BCRP_API fill:#fff3e0
📝 许可证
本项目根据 Apache许可证2.0 授权。
🙏 致谢
- BCRP 提供秘鲁经济数据的开放访问
- bcrpy 库用于BCRP数据的Python接口 (https://github.com/andrewrgarcia/bcrpy)
注意： bcrpy 在早期开发中被使用，但不再是依赖项。不幸的是，远程MCP服务器的性能导致响应超时。
<div align="center"> </div>