FRED Economic Data

FRED MCP 服务 📊

为 Claude Desktop 和任何兼容 MCP 的客户端提供美国及全球经济数据，由 FRED（Federal Reserve Economic Data）提供支持。通过自然语言搜索和获取 800,000+ 条经济时间序列，涵盖 GDP、通胀、失业率、利率等数据。

npm 包： fred-economic-mcp  ·  GitHub 仓库： danishashko/fred-economic-mcp。

🎯 你将获得

• 🔎 按关键词搜索 80 万多条经济时间序列
• 📈 观测值，支持内置转换（水平值、变化百分比、同比变化）和频率汇总（每日 → 每月/每季度/每年）
• 🧾 时间序列元数据——单位、频率、季节性调整、覆盖范围、备注
• 🇺🇸 经济概览——一次调用即可获取美国主要指标
• 🗂️ 浏览类别，按主题发现数据
• 🗓️ FRED 跟踪的数据发布

默认情况下，每个工具都会返回易读的 Markdown，也可按需返回结构化 JSON（response_format: "json"）。服务轻量（仅使用 Python 标准库和 mcp），在服务端应用 FRED 的转换，为 AI 提供整洁的数据，并在 FRED 限流时自动重试。

🔑 获取免费 API 密钥（必需）

FRED 需要免费的 API 密钥。整个过程大约需要一分钟：

1. 在 fredaccount.stlouisfed.org 创建账户，并在 fredaccount.stlouisfed.org/apikeys 申请密钥。
2. 通过 FRED_API_KEY 环境变量将密钥提供给服务（参见下方配置）。

🚀 快速开始

将以下内容添加到 Claude Desktop 配置中，然后重启 Claude：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fred": {
      "command": "npx",
      "args": ["-y", "fred-economic-mcp"],
      "env": {
        "FRED_API_KEY": "your_free_fred_api_key_here"
      }
    }
  }
}

首次启动时，npx 封装程序会创建隔离的 Python 环境并为你安装依赖项（仅需执行一次，可能需要一分钟）。你的设备上只需安装 Python 3.10+ 和 Node.js 16+。

更倾向于全局安装？

npm install -g fred-economic-mcp

{
  "mcpServers": {
    "fred": {
      "command": "fred-economic-mcp",
      "env": { "FRED_API_KEY": "your_free_fred_api_key_here" }
    }
  }
}

🔧 可用工具

工具	返回内容	参数
search_series	与关键词匹配的时间序列，按热度排序（ID、标题、单位、频率）	query、limit
get_series_observations	实际数据值，支持转换和频率汇总	series_id、observation_start、observation_end、units、frequency、sort_order、limit
get_series_info	时间序列的元数据（单位、频率、季节性调整、覆盖范围、备注）	series_id
get_economic_snapshot	仪表板中美国主要指标的最新值	（无）
browse_category	FRED 类别中的子类别和热门时间序列	category_id
get_releases	FRED 跟踪的经济数据发布	limit

每个工具还接受 response_format（默认为 "markdown"，也可以是 "json"）。

get_series_observations 转换（units）： lin 水平值 · chg 变化值 · ch1 与去年同期相比的变化 · pch 变化百分比 · pc1 与去年同期相比的变化百分比 · pca 复合年化率 · log 自然对数。

频率汇总（frequency）： 空（原生频率） · d 每日 · w 每周 · m 每月 · q 每季度 · a 每年。

常用序列 ID

你不需要记住 ID——search_series 会帮你查找——但以下这些经常用到：

序列 ID	指标
GDPC1	实际国内生产总值
UNRATE	失业率
CPIAUCSL	消费者价格指数（CPI）
PCEPI	PCE 价格指数（美联储偏好的通胀指标）
FEDFUNDS	联邦基金利率
DGS10	10 年期美国国债收益率
T10Y2Y	10 年期与 2 年期美国国债收益率利差
PAYEMS	非农就业人数
MORTGAGE30US	30 年期固定利率抵押贷款利率
UMCSENT	消费者信心（密歇根大学）

💬 示例提示词

连接服务后，只需向 Claude 提问：

• “美国经济目前表现如何？”
• “当前失业率是多少？”
• “显示过去 12 个月的 CPI 同比通胀率。”
• “10 年期美国国债收益率是多少？今年以来走势如何？”
• “查找有关消费信贷的 FRED 序列。”
• “10 年期与 2 年期收益率利差是多少？收益率曲线是否倒挂？”
• “比较过去 8 个季度的实际 GDP 增长情况。”
• “PCEPI 序列衡量什么？多久更新一次？”

输出示例

询问 “最近几个月的 CPI 同比通胀率是多少？” 会运行 get_series_observations，参数为 series_id=CPIAUCSL、units=pc1：

# Consumer Price Index for All Urban Consumers: All Items (CPIAUCSL)

**Units:** Percent change from year ago · **Frequency:** m
**Total observations:** 940

**Latest:** 3.39 (2026-04-01)

| Date       | Value |
|------------|-------|
| 2026-04-01 | 3.39  |
| 2026-03-01 | 3.29  |
| 2026-02-01 | 2.43  |

🐛 故障排除

“未配置 FRED API 密钥” 在 MCP 客户端配置中设置 FRED_API_KEY（参见“快速开始”），使用从 fredaccount.stlouisfed.org/apikeys 获取的免费密钥，然后重启客户端。

“找不到命令”／“找不到 Python” 确保已安装 Python 3.10+ 和 Node.js 16+，且它们位于 PATH 中。在 macOS/Linux 上，可尝试使用 python3。

“FRED 正在限制请求频率” FRED 对每个密钥每分钟允许 120 个请求。服务会自动重试；如果仍遇到此问题，请等待一分钟。

Claude 中未显示工具

1. 确认配置文件是有效的 JSON（末尾没有逗号）。
2. 完全退出并重新打开 Claude Desktop。
3. 检查服务的 env 块中是否设置了 FRED_API_KEY。

“FRED 拒绝了请求” 序列 ID 可能有误。使用 search_series 查找正确的 ID，或使用 get_series_info 确认序列是否存在。

使用其他模型或提供商（LiteLLM、OpenRouter、NVIDIA NIM、本地模型） 此服务不会与模型通信。客户端会将其作为本地进程启动，并通过 stdin/stdout 使用 JSON-RPC 通信，因此更改 ANTHROPIC_BASE_URL 或更换客户端使用的模型不会对其产生影响。如果这样切换后工具不再触发，请检查两点：模型必须支持函数调用；配置为丢弃不受支持参数的代理可能会静默移除工具定义，且不会报错。在怀疑服务本身之前，请先在客户端中运行 /mcp（或 claude mcp list）确认服务已连接。

🛠️ 手动安装（替代方式）

如果你想直接运行 Python 文件，而不是通过 npx 运行：

1. 下载服务并安装依赖项

将 fred_mcp.py 保存到计算机上的某个位置，然后：

pip install mcp

（在 macOS/Linux 上使用 pip3）

2. 将 Claude Desktop 指向该文件

{
  "mcpServers": {
    "fred": {
      "command": "python3",
      "args": ["/absolute/path/to/fred_mcp.py"],
      "env": { "FRED_API_KEY": "your_key_here" }
    }
  }
}

在 Windows 上使用 "command": "python"，并设置类似 "C:\\path\\to\\fred_mcp.py" 的路径（使用双反斜杠或正斜杠）。

3. 重启 Claude Desktop。

🔒 隐私与速率限制

• 使用官方 FRED API 和你自己的免费 API 密钥。
• 请求直接从你的计算机发送至 FRED。不会存储或通过代理转发任何内容。
• FRED 对每个密钥的速率限制为每分钟 120 个请求；服务遇到 429 时会采用退避策略重试。
• 适用于个人、教育和研究用途。

📝 备注

• 此处的序列 ID 不区分大小写（会自动转为大写），例如，unrate 可用。
• FRED 使用 . 标记缺失观测值；此处将其显示为 N/A。
• units 转换（例如，用于表示同比百分比的 pc1）由 FRED 计算，因此数值具有权威性——无需在客户端进行计算。
• 不同序列的数据覆盖范围和频率各异；提取数据范围前，请使用 get_series_info 进行检查。

📋 更新日志

完整的版本历史请参阅 CHANGELOG.md。

📚 资源

• Model Context Protocol
• FRED API 文档
• 获取 FRED API 密钥

⚖️ 法律免责声明

此工具使用 FRED® API，但未经圣路易斯联邦储备银行认可或认证。FRED® 是圣路易斯联邦储备银行的注册商标。使用 FRED API 须遵守其使用条款。

👤 作者

Daniel Shashko

• GitHub： @danishashko
• LinkedIn：daniel-shashko
• npm：danielshashko

📄 许可证

MIT © Daniel Shashko