经济金融数据协议服务器

BCRP-MCP是一个模型上下文协议服务器,提供对秘鲁中央储备银行经济金融时间序列数据的标准化访问,支持搜索、探索和分析经济指标、金融统计和货币数据。

  • by rodcar
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 rodcar/bcrp-mcp

使用说明

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_code
start
end
检索日期范围内特定代码的时间序列数据

注: 使用远程服务器时,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.


🙏 致谢

注: bcrpy在早期开发中使用,不再是依赖项。不幸的是,远程MCP服务器的性能导致了响应超时。


报告Bug · 请求功能