项目简介

此MCP服务器提供对联邦储备经济数据 (FRED) API的访问。它允许LLM检索宏观经济指标并搜索相关数据系列,从而为LLM应用提供经济数据上下文。

主要功能点

  • 访问FRED经济数据: 提供对常见FRED经济指标(如GDP、就业、通货膨胀等)的访问。
  • 数据搜索功能: 允许用户通过关键词搜索FRED数据系列。
  • 实时数据获取: 从FRED API实时获取最新的经济数据。
  • 标准化数据格式: 所有数据均以标准化的格式提供,方便LLM客户端解析和使用。

安装步骤

  1. 克隆仓库: 打开终端,执行命令 'git clone https://github.com/hungson175/WM_MCP.git' 克隆仓库到本地,并进入仓库目录 'cd WM_MCP'。
  2. 创建并激活虚拟环境: 为了隔离项目依赖,建议创建虚拟环境。执行 'uv venv' 创建虚拟环境,然后执行 'source .venv/bin/activate' (Linux/macOS) 或 '.venv\Scripts\activate' (Windows) 激活虚拟环境。
  3. 安装依赖: 在虚拟环境中,执行 'uv pip install "mcp[cli]>=1.6.0" "colorama>=0.4.6" "numpy>=2.2.4" "pandas>=2.2.3" "python-dotenv>=1.1.0" "requests>=2.32.3"' 安装项目所需的Python库。
  4. 配置FRED API密钥: 复制 '.env.example' 文件并重命名为 '.env'。编辑 '.env' 文件,将 'FRED_API_KEY=your_fred_api_key_here' 中的 'your_fred_api_key_here' 替换为您在 FRED API 官网 申请的API密钥。

服务器配置 (用于 Claude Desktop)

要将此MCP服务器配置到 Claude Desktop 客户端,您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。在配置文件中添加 'mcpServers' 字段,并配置 "FRED Macroeconomic Data Server"。配置信息如下:

{
  "mcpServers": {
    "FRED Macroeconomic Data Server": {
      "command": "/path/to/your/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/your/WM_MCP",
        "run",
        "fred_macroeco_server.py"
      ]
    }
  }
}

请注意:

  • 将配置中的 '/path/to/your/' 替换为实际的路径。
    • '/path/to/your/.local/bin/uv' 应替换为您 'uv' 命令的完整路径。您可以在终端中运行 'which uv' 来查找 'uv' 的路径。
    • '/path/to/your/WM_MCP' 应替换为您克隆的 'WM_MCP' 仓库的完整路径。
  • 'command' 字段指定了启动服务器的命令,这里使用了 'uv' 来运行 Python 脚本。
  • 'args' 字段指定了传递给 'uv' 命令的参数,包括仓库目录和服务器启动脚本 'fred_macroeco_server.py'。

基本使用方法

  1. 启动 Claude Desktop: 确保您已安装并启动 Claude Desktop 客户端。
  2. 配置 MCP 服务器: 按照上述 “服务器配置” 部分的说明,编辑 'claude_desktop_config.json' 文件,添加 FRED宏观经济数据服务器的配置。
  3. 在 Claude 中使用: 在 Claude Desktop 中,您可以像正常对话一样与 Claude 交互。当您需要使用FRED数据时,可以直接在提示语中指示 Claude 使用 MCP 资源或工具。例如:
    • '使用FRED API获取过去20年美国的GDP数据并绘制图表'
    • '搜索关于失业率的FRED数据'

可用资源:

  • 'file://series/available': 列出所有可用的FRED数据系列及其详细信息。

可用工具:

  • 'fetch_series_data': 获取指定FRED数据系列的数据。
  • 'search_series': 根据关键词搜索FRED数据系列。

信息

分类

网页与API