FRED 宏观经济数据 MCP 服务器

这是一个通过 Claude 和其他大型语言模型（LLM）客户端提供对联邦储备经济数据（FRED）访问的模型上下文协议（MCP）服务器。该服务器公开了 FRED 经济数据系列、搜索功能和数据检索工具。

功能

• 访问常见的 FRED 经济指标（如 GDP、就业、通货膨胀等）
• 对 FRED 数据系列进行搜索的功能
• 实时从 FRED API 获取数据
• 标准化的数据格式，便于 LLM 消费
• 使用 MCP Python SDK 构建，实现无缝集成

预备条件

• Python 3.11 或更高版本
• uv - 现代 Python 包安装器
• Claude Desktop 用于本地使用
• FRED API 密钥（从 FRED API 获取）

安装

1. 克隆仓库：

git clone https://github.com/yourusername/WM_mcp.git
cd WM_mcp

2. 使用 uv 创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # 在 Windows 上使用 `.venv\Scripts\activate`

3. 使用 uv 安装依赖项：

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"

4. 设置环境变量：

cp .env.example .env

编辑 .env 并添加你的 FRED API 密钥：

FRED_API_KEY=your_fred_api_key_here

在 Claude Desktop 中安装

1. 确保已安装并运行 Claude Desktop
2. 打开 Claude Desktop 设置：
   • 前往设置 > 开发者 > 编辑配置
   • 将以下配置添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "FRED 宏观经济数据服务器": {
      "command": "/path/to/your/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/your/WM_mcp",
        "run",
        "fred_macroeco_server.py"
      ]
    }
  }
}

用实际路径替换 /path/to/your/。你可以在终端中运行 which uv 来找到 uv 的路径。

在 Claude 中使用

1. 首先，在线搜索“在 Claude Desktop 客户端中使用 MCP 资源”，以了解如何在对话中包含 MCP 资源。
2. 添加资源后，你可以与 FRED 数据互动。例如提示：

使用 FRED API 获取过去 20 年美国的 GDP，并绘制图表

可用资源

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

可用工具

• fetch_series_data - 获取任何 FRED 系列的数据
• search_series - 通过描述搜索 FRED 系列

开发

对于开发和测试：

1. 运行 MCP Inspector 测试服务器：

mcp dev fred_macroeco_server.py

这允许你检查资源、测试工具并验证服务器功能。

2. 直接执行服务器（检查问题）：

python fred_macroeco_server.py

注意：服务器使用标准 I/O 传输与 Claude Desktop 通信。在部署到 Claude Desktop 之前，请使用 MCP Inspector 进行开发，以便捕获并修复任何问题。

故障排除

1. 如果遇到 API 密钥错误：

   • 验证你的 FRED API 密钥是否正确设置在 .env 中
   • 检查 .env 文件是否位于正确的目录中

2. 如果服务器没有出现在 Claude Desktop 中：

   • 再次检查你的 claude_desktop_config.json 路径
   • 确保 uv 和所有依赖项都已正确安装
   • 尝试重新启动 Claude Desktop

致谢

• 圣路易斯联邦储备银行，提供 FRED API
• 模型上下文协议团队，提供 MCP SDK
• Anthropic，提供 Claude 和 Claude Desktop 客户端