FRED (economic data)

fred-mcp

在你的 AI Agent 中使用 FRED® 经济数据——包括修订之前公布的数据。 一个适用于圣路易斯联邦储备银行 FRED® API 的 MCP 服务：搜索并读取 800,000 多条美国和国际时间序列，查看发布日历；其独特之处在于，还能查询ALFRED® 历史版本数据：查看任意时间序列在过去某一天的确切数据，以及任意单个数据点从首次公布到当前值的完整修订历史。

只读，基于公共端点，使用你自己的免费 FRED API 密钥。实时调用 API，并采用感知波动性的缓存策略（历史版本数据不可变，缓存时间较长；当前数据保持最新）——不进行批量镜像。

本产品使用 FRED® API，但未经圣路易斯联邦储备银行认可或认证。使用此服务即表示你同意 FRED® API 使用条款。

状态： v0.1.0 — 已发布至 PyPI （uvx mcpwright-fred）和官方 MCP Registry （io.github.mcpwright/fred-mcp）。包含 9 个工具，通过 CI 门禁，基于 mcpwright-core 构建。

为什么历史版本数据很重要

经济数据会被修订，有时幅度还很大。2008 年第 4 季度实际 GDP 的初步估值显示，经济萎缩速度远慢于当前公布的数据。如果 Agent 使用当前数据来推断决策者当时掌握的信息，就会在不知不觉中得出错误结论。get_series_as_of 和 get_revision_history 让查询已发布的数据成为一等问题。

工具

工具	功能
search_series	通过自由文本查找时间序列 ID，并优先显示最佳匹配项
get_series	获取单条时间序列的完整元数据和原始注释
get_observations	获取指定日期范围内的数值；支持变换（pct_change_yoy，……）和降采样
get_latest	获取最新数值和下一次计划发布日期
compare_series	将 2–5 条时间序列按同一日期轴对齐
get_release_calendar	查看即将发布的数据（“下一次就业报告什么时候发布？”）
get_series_as_of ⭐	查看某条时间序列在过去某一天的确切数据（ALFRED 历史版本）
get_revision_history ⭐	查看单个数据点的完整历程：首次公布 → 每次修订 → 当前值
get_vintage_dates ⭐	查看某条时间序列的发布日期或修订日期；用于确定历史版本工具的查询范围

所有工具均为只读，并已标注为只读。

可以问些什么？

以下每个问题都通过这些工具实时调用真实的 FRED API 运行过（答案截至 2026 年 6 月——再次提问即可获取最新数据）。

日常问题：

1. “现在的失业率是多少？下一次就业报告什么时候发布？” — get_latest(UNRATE) → 4.3%（2026 年 5 月），下一次发布于 2026-07-02。
2. “今天的 10 年期国债收益率是多少？” — get_latest(DGS10) → 4.53%（它会正确跳过日度序列在节假日发布的 . 行）。
3. “过去一年通胀趋势如何？” — get_observations(CPIAUCSL, transform=pct_change_yoy) → 2026 年 2 月至 5 月分别为 2.4% → 3.3% → 3.8% → 4.2%。
4. “帮我找一些家庭收入中位数的数据。” — search_series → MEHOINUSA672N（实际值）和 MEHOINUSA646N（名义值），按年统计。
5. “劳动力市场是否在降温？比较 2024 年以来的失业率和职位空缺数。” — compare_series([UNRATE, JTSJOL]) → 一张对齐后的表格。
6. “本周会发布哪些经济数据？” — get_release_calendar(7) → 241 个发布日期，包含 CPI。
7. “2025 年每个季度的实际 GDP 增长率是多少？” — get_observations(A191RL1Q225SBEA) → −0.6、+3.8、+4.4、+0.5%。
8. “给我一份 2020 年代 CPI 年平均值。” — get_observations(CPIAUCSL, frequency=annual) → 每年一行。

只有版本工具才能回答的问题：

9. “2009 年初的政策制定者怎么看待 2008 年第四季度的 GDP？与我们现在掌握的信息相比如何？” — get_series_as_of(GDPC1, "2009-02-15") → 按当时已知数据，年化降幅为 −3.8%（以链式 2000 年美元计——元数据也固定在该版本），而今天的数据为 −8.5%。政策决策依据的是第一个数字。
10. “2020 年 5 月的 COVID 失业率后来修订过吗？” — get_revision_history(UNRATE, "2020-05-01") → 首次于 2020-06-05 发布时为 13.3，目前为 13.2，并列出了每次修订的日期。
11. “美联储在 2022 年 3 月加息会议前看到的抵押贷款利率是多少？” — get_series_as_of(MORTGAGE30US, "2022-03-16") → 按当时已知数据为 3.85%；今天为 6.48%。
12. “GDP 实际上多久会修订一次？” — get_vintage_dates(GDPC1) → 自 1991-12-04 以来共有 415 个版本。

安装

你需要一个免费的 FRED API 密钥（几秒钟即可获取）： https://fred.stlouisfed.org/docs/api/api_key_request.html。根据 FRED 条款，密钥仅供个人使用——请使用你自己的密钥。

uvx（任意 MCP 客户端）

{
  "mcpServers": {
    "fred": {
      "command": "uvx",
      "args": ["mcpwright-fred"],
      "env": { "FRED_API_KEY": "your-key-here" }
    }
  }
}

Claude Code

claude mcp add fred -e FRED_API_KEY=your-key-here -- uvx mcpwright-fred

Claude Desktop

使用最新版本中的一键式 .mcpb 扩展（它会提示你输入 API 密钥），或将上方的 uvx JSON 添加到你的 claude_desktop_config.json 中。

OpenAI Agents SDK / 其他客户端

任何支持 MCP 的客户端都可使用——通过 stdio 将其指向 uvx mcpwright-fred，并在环境中设置 FRED_API_KEY。

注意事项

• 修订： 当前值往往与最初发布的值不同；若想了解“当时已知的信息”，请使用版本工具。
• 受版权保护的序列： 部分 FRED 序列归第三方所有；其说明中包含所有者的条款（原文显示，并通过 copyrighted 标记）。个人使用之外，你有责任遵守这些条款。
• 缓存与速率限制： 响应会缓存在内存中（版本读取的缓存时间较长，实时读取较短），请求频率也受到限制，远低于 FRED 的速率限制。设置 FRED_MCP_CACHE=0 可禁用缓存；设置 FRED_MCP_USER_AGENT 可标识你自己的部署。

开发

git clone https://github.com/mcpwright/fred-mcp && cd fred-mcp
uv sync
uv run pytest                                  # tests
uv run mypy                                    # types
uv run ruff check src/ && uv run ruff format --check src/   # lint + format
uv run pre-commit run --all-files              # everything, like CI

开发流程：功能分支 → PR → Code Quality & Tests 检查通过 → 压缩合并。

路线图

• v1 工具集（共 9 个工具，包含 ALFRED 版本数据功能）
• 发布到 PyPI（mcpwright-fred）和 MCP Registry
• 在 mcpwright.com/fred 上发布项目页面
• .mcpb Claude Desktop 一键式扩展（v0.1.0 版本）
• GeoFRED / 地图（与 census-mcp 配套）

问题与反馈

如有问题或想法，请前往 讨论区；如需报告 Bug，请前往 Issues。

---

本项目属于 mcpwright —— 为权威公共数据打造的精良 MCP 服务 · 由 Devender Gollapally 构建。 FRED® 和 ALFRED® 是圣路易斯联邦储备银行的注册商标。本项目与圣路易斯联邦储备银行无关，也未获得其认可或认证。