MCP-FREDAPI

FRED (联邦储备经济数据) API 与模型上下文协议 (MCP) 集成

目录

• 简介
• 安装
• 配置
  • FRED API 密钥
  • Claude/Cursor 配置
• 可用工具
• 参数
• 示例
  • 常用经济序列 ID
• 贡献
• 许可证
• 参考

简介

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

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

安装

有两种安装方法：

方法 1：使用 pip

安装所需的依赖项：

pip install "mcp[cli]" httpx python-dotenv

克隆此存储库：

git clone https://github.com/Jaldekoa/mcp-fredapi.git
cd mcp-fredapi

方法 2：使用 uv (推荐)

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

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

pip install uv

2. 克隆此存储库：

git clone https://github.com/Jaldekoa/mcp-fredapi.git
cd mcp-fredapi

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

uv run --with mcp --with httpx mcp run server.py

配置

FRED API 密钥

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

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

FRED_API_KEY=your_api_key_here

Claude/Cursor 配置

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

{
  "mcpServers": {
    "mcp-fredapi": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-fredapi", "run", "--with", "mcp", "--with", "httpx", "mcp", "run", "server.py"]
    }
  }
}

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

{
  "mcpServers": {
    "mcp-fredapi": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-fredapi", "run", "--with", "mcp", "--with", "httpx", "mcp", "run", "server.py"]
    }
  }
}

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

可用工具

get_fred_series_observations

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

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

@mcp-fredapi:get_fred_series_observations

参数

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

参数	类型	描述	允许值	默认值	状态
series_id	str	经济序列的 ID	-	(必需)	✅ 工作正常
sort_order	str	观测值的排序顺序	'asc', 'desc'	'asc'	✅ 工作正常
units	str	数据值转换	'lin', 'chg', 'ch1', 'pch', 'pc1', 'pca', 'cch', 'cca', 'log'	'lin'	✅ 工作正常
frequency	str	观测值的频率	'd', 'w', 'bw', 'm', 'q', 'sa', 'a', 'wef', 'weth', 'wew', 'wetu', 'wem', 'wesu', 'wesa', 'bwew', 'bwem'	None	✅ 工作正常
aggregation_method	str	频率的聚合方法	'avg', 'sum', 'eop'	'avg'	✅ 工作正常
output_type	int	观测值的输出类型	1, 2, 3, 4	1	✅ 工作正常
realtime_start	str	实时周期的开始 (YYYY-MM-DD)	-	None	❌ 不工作
realtime_end	str	实时周期的结束 (YYYY-MM-DD)	-	None	❌ 不工作
limit	int/str	要返回的最大观测值数量	介于 1 和 100000 之间	10	❌ 不工作
offset	int/str	从开头跳过的观测值数量	-	0	❌ 不工作
observation_start	str	观测值的开始日期 (YYYY-MM-DD)	-	None	❌ 不工作
observation_end	str	观测值的结束日期 (YYYY-MM-DD)	-	None	❌ 不工作
vintage_dates	str	逗号分隔的旧数据日期列表	-	None	❌ 不工作

[!WARNING] 参数兼容性说明

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

• ✅ 工作正常的参数：series_id、sort_order、units、frequency、aggregation_method 和 output_type。
• ❌ 不工作的参数：realtime_start、realtime_end、limit、offset、observation_start、observation_end 和 vintage_dates。

为了获得最佳结果，请在查询中使用工作正常的参数。 未来的更新可能会解决这些限制。

示例

获取美国 GDP 数据

在 Cursor 中使用 Claude 时，您可以这样询问 GDP 数据：

你能从 FRED 获取最新的 GDP 数据吗？

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP"
}

按降序获取 GDP 数据

你能按降序（最新在前）获取 GDP 数据吗？

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP",
  "sort_order": "desc"
}

获取年度 GDP 数据

你能获取年度 GDP 数据吗？

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP",
  "frequency": "a"
}

获取通货膨胀率

要获取消费者价格指数数据，并显示百分比变化：

美国最近的通货膨胀率是多少？

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "CPIAUCSL",
  "units": "pch",
  "frequency": "m"
}

不同的输出格式

以不同的格式显示 GDP 数据。

@mcp-fredapi:get_fred_series_observations
{
  "series_id": "GDP",
  "output_type": 2
}

贡献

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

1. Fork 存储库
2. 创建一个功能分支 (git checkout -b feature/amazing-feature)
3. 进行更改
4. 提交更改 (git commit -m 'Add an amazing feature')
5. 推送到分支 (git push origin feature/amazing-feature)
6. 打开一个 Pull Request

许可证

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

参考

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