🚀 FRED 宏观经济数据 MCP 服务器

FRED 宏观经济数据 MCP 服务器是一个借助 Claude 及其他 LLM 客户端，来访问联邦储备经济数据（FRED）的 Model Context Protocol (MCP) 服务器。它提供了对 FRED 经济数据系列、搜索功能以及数据检索工具的访问途径，能助力用户便捷获取和处理宏观经济数据。

✨ 主要特性

• 常见指标访问：可访问常见的 FRED 经济指标，如 GDP、就业、通货膨胀等。
• 数据搜索功能：具备搜索 FRED 数据系列的能力。
• 实时数据获取：能实时从 FRED API 获取数据。
• 标准数据格式：提供适合 LLM 使用的标准数据格式。
• 无缝集成构建：可使用 MCP Python SDK 进行无缝集成构建。

📦 安装指南

环境准备

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

安装步骤

1. 克隆仓库：

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

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

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

3. 安装依赖项：

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",
        "运行",
        "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 系列及其详细信息。

🔧 故障排除

如果在安装或配置过程中遇到问题，请检查以下内容：

1. 确保已正确设置 FRED_API_KEY。
2. 确认 Python 和 uv 已正确安装。
3. 验证网络连接，确保可以访问外部 API。

如仍有问题，请参考相关文档或联系支持团队。