FRED宏观经济数据MCP服务器

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

特征

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

• FRED 数据系列的搜索功能

• 从 FRED API 获取实时数据

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

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

先决条件

• Python 3.11 或更高版本

• uv——现代 Python 软件包安装程序

• 供本地使用的Claude Desktop

• FRED API 密钥（从FRED API获取）

安装

1. 克隆存储库：

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

3. 使用 uv 安装依赖项：

4. 设置环境变量：

编辑.env并添加您的 FRED API 密钥：

在 Claude Desktop 中安装

1. 确保 Claude Desktop 已安装并正在运行

2. 打开Claude桌面设置：

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

   • 将以下配置添加到您的claude_desktop_config.json ：

将/path/to/your/替换为你的实际路径。你可以在终端中运行which uv来找到 uv 的路径。

Claude 中的用法

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

2. 添加资源后，您就可以与 FRED 数据进行交互。示例提示：

可用资源

• file://series/available - 列出所有可用的 FRED 系列及其详细信息

可用工具

• fetch_series_data - 获取任何 FRED 系列的数据

• search_series - 根据描述搜索 FRED 系列

发展

对于开发和测试：

1. 运行 MCP Inspector 来测试服务器：

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

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

注意：服务器使用 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 桌面客户端