弗雷德-MCP服务器

Name: 弗雷德-MCP服务器
Author: stefanoamorelli

作者：stefanoamorelli53 星标更新：2025-11-02

安装使用来源：spider==github.com

项目介绍

联邦储备经济数据 MCP 服务器

[!IMPORTANT] 免责声明: 此开源项目与联邦储备或圣路易斯联邦储备银行无关、不受其赞助或认可。“FRED”是圣路易斯联邦储备银行的注册商标，在此仅用于描述目的。

一个模型上下文协议（MCP）服务器，通过三个强大的工具提供对超过800,000个联邦储备经济数据（FRED®）时间序列的通用访问。

https://github.com/user-attachments/assets/66c7f3ad-7b0e-4930-b1c5-a675a7eb1e09

[!TIP] 如果您在研究或工作中使用了这个项目，请使用CITATION.cff文件引用它，或者使用以下引用：

APA 格式:

Amorelli, S. (2025). 联邦储备经济数据 MCP (模型上下文协议) 服务器 (版本 1.0.2) [计算机软件]. Zenodo. https://doi.org/10.5281/zenodo.14536707

BibTeX:

@software{amorelli_2025_14536707,
  author       = {Amorelli, Stefano},
  title        = {{联邦储备经济数据 MCP (模型上下文
                   协议) 服务器}},
  month        = jan,
  year         = 2025,
  publisher    = {Zenodo},
  version      = {1.0.2},
  doi          = {10.5281/zenodo.14536707},
  url          = {https://doi.org/10.5281/zenodo.14536707}
}

安装

通过 Smithery 安装

要通过 Smithery 自动安装联邦储备经济数据服务器到 Claude Desktop：

npx -y @smithery/cli install @stefanoamorelli/fred-mcp-server --client claude

手动安装

克隆仓库：

git clone https://github.com/stefanoamorelli/fred-mcp-server.git
cd fred-mcp-server

安装依赖：
```
pnpm install
```
构建项目：
```
pnpm build
```

配置

此服务器需要一个 FRED® API 密钥。您可以在 FRED® 网站上获取一个。

安装服务器，例如在 Claude Desktop，修改 claude_desktop_config.json 文件并添加以下配置：

{
  "mcpServers": {
    "FRED MCP 服务器": {
      "command": "/usr/bin/node",
      "args": [
        "<克隆仓库路径>/fred-mcp-server/build/index.js"
      ],
      "env": {
        "FRED_API_KEY": "<您的API密钥>"
      }
    }
  }
}

使用 Docker

您也可以使用 Docker 运行 FRED MCP 服务器。将此配置添加到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "fred-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "FRED_API_KEY=<您的API密钥>",
        "stefanoamorelli/fred-mcp-server:latest"
      ],
      "env": {}
    }
  }
}

将 <您的API密钥> 替换为您实际的 FRED API 密钥。

可用工具

此 MCP 服务器提供了三个全面的工具来访问所有超过800,000个 FRED® 经济数据系列：

`fred_browse`

描述: 通过类别、发布或来源浏览 FRED 的完整目录。

参数:

browse_type (必需): 浏览类型 - "categories", "releases", "sources", "category_series", "release_series"
category_id (可选): 浏览子类别或类别内系列的类别ID
release_id (可选): 浏览发布内系列的发布ID
limit (可选): 结果的最大数量（默认：50）
offset (可选): 为分页跳过的结果数
order_by (可选): 按字段排序结果
sort_order (可选): "asc" 或 "desc"

`fred_search`

描述: 通过关键词、标签或过滤器搜索 FRED 经济数据系列。

参数:

search_text (可选): 在系列标题和描述中搜索的文本
search_type (可选): "full_text" 或 "series_id"
tag_names (可选): 用于过滤的逗号分隔标签名称列表
exclude_tag_names (可选): 排除的逗号分隔标签名称列表
limit (可选): 结果的最大数量（默认：25）
offset (可选): 为分页跳过的结果数
order_by (可选): 按字段排序（如："popularity", "last_updated"）
sort_order (可选): "asc" 或 "desc"
filter_variable (可选): 按 "frequency", "units", 或 "seasonal_adjustment" 过滤
filter_value (可选): 用于过滤变量的值

`fred_get_series`

描述: 通过其ID检索任何 FRED 系列的数据，并支持转换和日期范围。

参数:

series_id (必需): FRED 系列ID（如："GDP", "UNRATE", "CPIAUCSL"）
observation_start (可选): 开始日期，YYYY-MM-DD 格式
observation_end (可选): 结束日期，YYYY-MM-DD 格式
limit (可选): 观测值的最大数量
offset (可选): 要跳过的观测值数
sort_order (可选): "asc" 或 "desc"
units (可选): 数据转换:
- "lin" (水平/无转换)
- "chg" (从上一周期的变化)
- "ch1" (从一年前的变化)
- "pch" (百分比变化)
- "pc1" (从一年前的百分比变化)
- "pca" (复合年增长率)
- "cch" (连续复合增长率)
- "log" (自然对数)
frequency (可选): 频率聚合 ("d", "w", "m", "q", "a")
aggregation_method (可选): "avg" (平均), "sum", 或 "eop" (期末)

示例用法

借助这三个工具，您可以：

浏览所有经济类别并发现可用数据
通过关键词或标签搜索特定指标
检索超过800,000个系列中的任何一个，并进行自定义转换
访问包括GDP、失业率、通货膨胀、利率等在内的实时经济数据

社交媒体推荐 📣

[!NOTE] 想被推荐吗？在您的关于使用 FRED MCP 服务器的文章中提及 Stefano Amorelli 或 @stefanoamorelli，或提交 PR 添加您的推荐！

我们感谢社区的支持！以下是来自一些杰出人士的一些提及：

<details open> <summary>Scott G - "我理解 Claude 的可能性的一个突破时刻就是这个 fred-mcp-server 项目..."</summary> <a href="https://www.linkedin.com/posts/sgoley_as-many-of-us-continue-to-use-llms-more-and-activity-7372401049669885952-ha6M"> <img src="assets/social/linkedin-sgoley.jpg" alt="Scott G 的 LinkedIn 帖子 - Fintech & 数据分析专业人士" width="600"> </a> Scott G - Fintech & 数据分析专业人士 | <a href="https://www.linkedin.com/in/sgoley/">LinkedIn 个人资料</a> </details> <details open> <summary>John Shelburne - "FRED MCP 服务器对于金融分析来说是一个游戏规则改变者..."</summary> <a href="https://www.linkedin.com/posts/shelburne_ai-finance-innovation-activity-7341141860880478210-JQe4"> <img src="assets/social/linkedin-john-shelburne.jpg" alt="John Shelburne 的 LinkedIn 帖子" width="600"> </a> John Shelburne - 固定收益金融科技领导者，拥有20多年经验 | 机器学习及云计算专家 | <a href="https://www.linkedin.com/in/shelburne/">LinkedIn 个人资料</a> </details>

测试

详情见 TESTING.md。

# 运行所有测试
pnpm test

# 运行特定测试
pnpm test:registry

许可证 ⚖️

此开源项目根据 GNU Affero 通用公共许可证 v3.0 (AGPL-3.0) 发布。这意味着：

您可以使用、修改和分发此软件
如果您修改并分发它，您必须在 AGPL-3.0 下发布您的更改
如果您在一个服务器上运行修改后的版本，您必须向用户提供源代码
详情见 LICENSE 文件

有关商业许可选项或其他许可查询，请联系 stefano@amorelli.tech。