MCP-FREDAPI

FRED（美联储经济数据）API 与模型上下文协议（MCP）集成

目录

• 介绍
• 安装
• 配置
  • FRED API 密钥
  • Claude/Cursor 配置
• 可用工具
• 参数
• 示例
  • 通用经济系列ID
• 贡献
• 执照
• 参考

介绍

MCP-FREDAPI 通过模型上下文协议 (MCP Protocol) 提供对圣路易斯联邦储备银行 (FRED) 经济数据的访问。此集成允许像 Claude 这样的 AI 助手在与 Cursor 或其他兼容 MCP 的环境配合使用时直接检索经济时间序列数据。

该软件包与官方 FRED API集成，特别关注为经济指标提供时间序列数据的series_observations 端点。

安装

安装方法有两种：

方法 1：使用 pip

安装所需的依赖项：

克隆此存储库：

方法二：使用 uv（推荐）

推荐使用此方法，因为它与 mcp.json 中显示的配置相匹配。

1. 首先，如果您还没有安装 uv，请安装它：

2. 克隆此存储库：

3. 使用 uv 运行服务器（无需单独安装依赖项）：

配置

FRED API 密钥

您需要一个 FRED API 密钥，您可以从FRED API获取。

在项目根目录中创建一个.env文件：

Claude/Cursor 配置

要配置 Cursor 使用此 MCP 服务器，请将以下内容添加到您的~/.cursor/mcp.json文件中：

将/path/to/mcp-fredapi替换为你系统上仓库的实际路径。例如：

注意：在 Windows 上，您可以在路径中使用正斜杠/或双反斜杠\\ 。

可用工具

获取fred_series_observations

从 FRED 检索经济时间序列观测数据。

在 Cursor 中使用 Claude 时，您可以直接使用以下方式访问此工具：

参数

get_fred_series_observations工具接受以下参数。有关每个参数的完整技术细节，请参阅官方 FRED API 文档。

关于参数兼容性的注意事项

由于当前 MCP 实施的限制，只有某些参数可以正常工作：

• ✅工作参数： series_id 、 sort_order 、 units 、 frequency 、aggregation_method , and output_type。
• ❌非工作参数： realtime_start 、 realtime_end 、 limit 、 offset 、 observation_start 、 observation_end和vintage_dates 。

为了获得最佳效果，请在查询中坚持使用有效参数。未来的更新可能会解决这些限制。

示例

获取美国GDP数据

在 Cursor 中使用 Claude 时，可以像这样请求 GDP 数据：

按降序获取 GDP 数据

获取年度GDP数据

获取通货膨胀率

获取百分比变化的消费者价格指数数据：

不同的输出格式

贡献

欢迎贡献。请按照以下步骤操作：

1. 分叉存储库
2. 创建功能分支（ git checkout -b feature/amazing-feature ）
3. 进行更改
4. 提交您的更改（ git commit -m 'Add an amazing feature' ）
5. 推送到分支（ git push origin feature/amazing-feature ）
6. 打开拉取请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

参考

• FRED API 文档 - 系列观察- 本项目使用的 FRED API 端点的官方文档。
• FRED API - 有关获取 API 密钥和一般 API 文档的信息。
• 模型上下文协议- 模型上下文协议的文档。