使用说明
BCRP-MCP
BCRP经济和金融时间序列数据的模型上下文协议(MCP)服务器
👨💻 作者
伊万·杨罗德里格斯·卡兰扎
📋 目录
🎯 概述
BCRP-MCP是一种 模型上下文协议(MCP)服务器 它提供了对经济和金融时间序列数据的无缝访问 秘鲁中央储备银行 -秘鲁中央储备银行。该服务器使人工智能代理和应用程序能够通过标准化的MCP接口搜索、探索和分析秘鲁的经济指标、金融统计数据和货币数据。
🎬 演示
https://github.com/user-attachments/assets/c42eb8c3-4a1c-442d-bd12-cc1fd4ff18ae
演示(西班牙语): https://youtube.com/shorts/gsjC07WR0n0
🔧 工具
| 名称 | 输入 | 描述 |
|---|---|---|
search_time_series_groups |
keywords |
使用一个或多个关键字搜索时间序列组 |
search_time_series_by_group |
time_series_group |
查找特定组内的所有时间序列,返回代码和名称对 |
get_time_series_data |
time_series_codestartend |
检索日期范围内特定代码的时间序列数据 |
注: 使用远程服务器时,MCP客户端可能需要增加连接超时设置。
💬 提示
| 名称 | 输入 | 描述 |
|---|---|---|
search_data |
keyword |
使用关键字搜索查找相关时间序列的指导工作流程 |
ask |
question |
提取关键字、搜索数据和回答问题的财务分析工作流程 |
🚀 如何使用
克劳德桌面(远程服务器)
注: 需要
npx它与npm捆绑在一起。如果你没有安装npm,请安装 Node.js 其中包括npm。
添加到Claude桌面配置(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桌面配置(Claude>设置>开发人员>编辑配置):
注: 替换
/path/to/bcrp-mcp使用克隆存储库的实际路径。
{
"mcpServers": {
"simple_mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/bcrp-mcp",
"run",
"main.py"
]
}
}
}
MCP检查员(备选)
注: 需要
npx它与npm捆绑在一起。如果你没有安装npm,请安装 Node.js 其中包括npm。
注: 替换
/path/to/bcrp-mcp使用克隆存储库的实际路径。
跑
npx @modelcontextprotocol/inspector \
uv \
--directory /path/to/bcrp-mcp \
run \
main.py
打开MCP检查器(控制台中显示的URL),并使用以下设置配置MCP客户端:
- 运输类型: 流式HTTP
- 网址:
http://bcrp-mcp.onrender.com/mcp - 请求超时: 从默认值增加
- 最大总超时时间: 从默认值增加
- 代理会话令牌: 使用控制台中生成的令牌
💡 例子
| 提示 | 语言 | 问题 | 对话 |
|---|---|---|---|
ask |
西班牙 | “去年基准利率是如何演变的?” | https://claude.ai/share/34df5f90-7a35-474d-b4cf-e8f48c3f9772 |
🏛️ 架构图
BCRP-MPCP遵循模型上下文协议规范,并在BCRP API上提供了一个干净的抽象层。
graph LR
CLIENT[MCP Client<br/>Claude Desktop, IDE, etc.] --> MCP_SERVER[BCRP-MCP Server]
subgraph TOOLS ["🔧 Tools"]
SEARCH_GROUP[search_time_serie_group]
SEARCH_SERIES[search_time_series_by_group]
GET_DATA[get_time_series_data]
end
subgraph "💬 Prompts"
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许可证2.0.
🙏 致谢
- BCRP 开放获取秘鲁经济数据
- bcrpy 用于BCRP数据的Python接口库(https://github.com/andrewrgarcia/bcrpy)
注: bcrpy在早期开发中使用,不再是依赖项。不幸的是,远程MCP服务器的性能导致了响应超时。