FRED Macroeconomic Data MCP Server

FRED宏观经济数据MCP服务器

一种模型上下文协议（MCP）服务器，通过Claude和其他LLM客户端提供对美联储经济数据（FRED）的访问。此服务器公开FRED经济数据系列、搜索功能和数据检索工具。

特性

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

先决条件

• Python 3.11或更高版本
• 紫外线 -现代Python包安装程序
• 克劳德桌面 供当地使用
• 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_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 在终端。

Claude中的用法

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

1. 添加资源后，您可以与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检查器以测试服务器：

mcp dev fred_macroeco_server.py

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

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

python fred_macroeco_server.py

注意：服务器使用stdio传输与Claude Desktop通信。在开发过程中使用MCP检查器，在部署到Claude Desktop之前捕获并修复任何问题。

故障排除

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

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

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

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

致谢

• 圣路易斯联邦储备银行提供FRED API
• MCP SDK的模型上下文协议团队
• 克劳德和克劳德桌面客户端的Anthropic