FRED宏观经济数据MCP服务器

模型上下文协议 (MCP) 服务器，可通过 Claude 和其他 LLM 客户端访问美联储经济数据 (FRED)。该服务器提供 FRED 经济数据系列、搜索功能和数据检索工具。

特征

• 获取常见的 FRED 经济指标（GDP、就业、通货膨胀等）

• FRED 数据系列的搜索功能

• 从 FRED API 获取实时数据

• LLM 消费的标准化数据格式

• 使用 MCP Python SDK 构建，实现无缝集成

Related MCP server: fred-mcp

先决条件

• 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  # On Windows, use `.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桌面设置：

   • 前往“设置”>“开发者”>“编辑配置”

   • 将以下配置添加到您的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 Client 中使用 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

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

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

python fred_macroeco_server.py

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

故障排除

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

   • 验证您的 FRED API 密钥是否在.env中正确设置

   • 检查.env文件是否位于正确的目录中

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

   • 仔细检查你的claude_desktop_config.json路径

   • 确保 uv 和所有依赖项都已正确安装

   • 尝试重启 Claude Desktop

致谢

• 圣路易斯联邦储备银行提供 FRED API

• MCP SDK 的模型上下文协议团队

• Claude 的 Anthropic 和 Claude 桌面客户端