FRED宏观经济数据MCP服务器
模型上下文协议 (MCP) 服务器,可通过 Claude 和其他 LLM 客户端访问美联储经济数据 (FRED)。该服务器提供 FRED 经济数据系列、搜索功能和数据检索工具。
特征
- 获取常见的 FRED 经济指标(GDP、就业、通货膨胀等)
- FRED 数据系列的搜索功能
- 从 FRED API 获取实时数据
- LLM 消费的标准化数据格式
- 使用 MCP Python SDK 构建,实现无缝集成
先决条件
安装
- 克隆存储库:
git clone https://github.com/yourusername/WM_mcp.git
cd WM_mcp
- 使用 uv 创建并激活虚拟环境:
uv venv
source .venv/bin/activate # On Windows, use `.venv\Scripts\activate`
- 使用 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"
- 设置环境变量:
编辑.env
并添加您的 FRED API 密钥:
FRED_API_KEY=your_fred_api_key_here
在 Claude Desktop 中安装
- 确保 Claude Desktop 已安装并正在运行
- 打开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 中的用法
- 首先,在线搜索“在 Claude Desktop Client 中使用 MCP 资源”以了解如何在对话中包含 MCP 资源。
- 添加资源后,您就可以与 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 系列
发展
对于开发和测试:
- 运行 MCP Inspector 来测试服务器:
mcp dev fred_macroeco_server.py
这使您可以检查资源、测试工具和验证服务器功能。
- 对于直接服务器执行(检查问题):
python fred_macroeco_server.py
注意:服务器使用 stdio 传输与 Claude Desktop 进行通信。在开发过程中,请使用 MCP 检查器来捕获并修复任何问题,然后再部署到 Claude Desktop。
故障排除
- 如果您收到 API 密钥错误:
- 验证您的 FRED API 密钥是否在
.env
中正确设置 - 检查
.env
文件是否位于正确的目录中
- 如果服务器没有出现在 Claude Desktop 中:
- 仔细检查你的
claude_desktop_config.json
路径 - 确保 uv 和所有依赖项都已正确安装
- 尝试重启 Claude Desktop
致谢
- 圣路易斯联邦储备银行提供 FRED API
- MCP SDK 的模型上下文协议团队
- Claude 的 Anthropic 和 Claude 桌面客户端