🚀 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 获取）
安装步骤
- 克隆仓库：
git clone https://github.com/yourusername/WM_mcp.git
cd WM_mcp
- 创建并激活虚拟环境：
uv venv
source .venv/bin/activate # 在 Windows 中，使用 `.venv\Scripts\activate`
- 安装依赖项：
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"
- 设置环境变量：
cp .env.example .env
编辑 .env 文件，并添加您的 FRED API 密钥：
FRED_API_KEY=your_fred_api_key_here
在 Claude Desktop 中安装
- 确保已安装并运行 Claude Desktop。
- 打开 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 中使用
- 首先，在线搜索“如何在 Claude Desktop 客户端中使用 MCP 资源”，以了解如何将 MCP 资源包含在对话中。
- 添加资源后，即可与 FRED 数据进行交互。示例提示：
使用 FRED API 获取美国过去 20 年的 GDP，绘制图表
可用资源
file://series/available- 列出所有可用的 FRED 系列及其详细信息。
🔧 故障排除
如果在安装或配置过程中遇到问题，请检查以下内容：
- 确保已正确设置 FRED_API_KEY。
- 确认 Python 和 uv 已正确安装。
- 验证网络连接，确保可以访问外部 API。
如仍有问题，请参考相关文档或联系支持团队。