FRED 宏观经济数据 MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过 Claude 和其他 LLM 客户端提供对联邦储备经济数据 (FRED) 的访问。此服务器公开 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 设置：
   • 转到 Settings > Developer > Edit Config
   • 将以下配置添加到您的 claude_desktop_config.json：

{
  "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/ 替换为您的实际路径。您可以通过在终端中运行 which uv 来找到 uv 的路径。

在 Claude 中使用

1. 首先，在线搜索“using MCP resource in Claude Desktop Client”，了解如何在对话中包含 MCP 资源。

2. 添加资源后，您可以与 FRED 数据进行交互。示例提示：

Use FRED APIs to get GDPs of USA last 20 years, draw chart

（使用 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

注意：服务器使用 stdio 传输与 Claude Desktop 通信。在开发期间使用 MCP Inspector 来捕获和修复任何问题，然后再部署到 Claude Desktop。

故障排除

1. 如果您收到 API 密钥错误：

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

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

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

致谢

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