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

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

uv venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`

1. 使用 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"

1. 设置环境变量：

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 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. 首先，在线搜索“在 Claude Desktop 客户端中使用 MCP 资源”以了解如何在对话中包含 MCP 资源。

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

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

可用资源

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

可用工具

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

开发

开发和测试：

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

mcp dev fred_macroeco_server.py

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

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

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
• Model Context Protocol 团队提供的 MCP SDK
• Anthropic 提供 Claude 和 Claude Desktop 客户端