AI导哈

经济数据协议服务器

fred-mcp-server 是一个提供完整 FRED API（联邦储备经济数据）访问的 MCP（模型上下文协议）服务器，包括地图 API 用于区域和地理数据。用户可以在 Claude 对话中搜索、探索和检索经济数据。

  • by floriancaro
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 floriancaro/fred-mcp-server

使用说明

fredmcp服务器

MCP（模型上下文协议）服务器，提供对完整内容的访问 FRED API公司 （美联储经济数据），包括用于区域和地理数据的地图API。使用它直接在克劳德对话中搜索、探索和检索经济数据。

免责声明： 本项目不隶属于圣路易斯联邦储备银行或任何联邦储备实体，也不受其认可或与之有联系。它是一个独立的开源工具，可以访问公开可用的FRED API。

特性

  • 33工具 涵盖所有FRED API端点，包括地图（系列、类别、发布、来源、标签、地图）
  • 完全参数支持——对分页或过滤没有人为限制
  • 内置速率限制（120个请求/分钟）
  • 异步HTTP客户端，用于高效处理请求

需求

安装

pip install fred-mcp-server

或与 紫外线:

uv tool install fred-mcp-server

使用Docker：

docker pull ghcr.io/floriancaro/fred-mcp-server

或者从源代码构建：

docker build -t fred-mcp-server https://github.com/floriancaro/fred-mcp-server.git

来源：

git clone https://github.com/floriancaro/fred-mcp-server.git
cd fred-mcp-server
uv sync --dev

配置

安装后，为您的首选客户端配置MCP服务器。

克劳德代码（CLI）

全局添加服务器（在所有项目中都可用）：

claude mcp add fred -s user -e FRED_API_KEY=your-api-key-here -- fred-mcp-server

或者仅将其添加到特定项目中：

claude mcp add fred -e FRED_API_KEY=your-api-key-here -- fred-mcp-server

验证它是否已连接：

claude mcp list

克劳德代码（项目配置）

或者，创建一个 .mcp.json 项目根目录中的文件：

{
  "mcpServers": {
    "fred": {
      "command": "fred-mcp-server",
      "env": {
        "FRED_API_KEY": "your-api-key-here"
      }
    }
  }
}

A. .mcp.json.example 文件作为模板包含在repo中。

克劳德桌面版

添加到您的Claude Desktop配置文件中：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "fred": {
      "command": "fred-mcp-server",
      "env": {
        "FRED_API_KEY": "your-api-key-here"
      }
    }
  }
}

保存后重新启动Claude Desktop。

码头工人

如果使用Docker镜像，请替换 command 字段：

{
  "mcpServers": {
    "fred": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "FRED_API_KEY", "ghcr.io/floriancaro/fred-mcp-server"],
      "env": {
        "FRED_API_KEY": "your-api-key-here"
      }
    }
  }
}

工具

系列

工具 说明
fred_series 获取系列的元数据
fred_series_search 按文本搜索系列
fred_series_observations 获取序列的数据值
fred_series_categories 获取系列的类别
fred_series_release 获取系列的发布
fred_series_tags 获取系列标签
fred_series_search_tags 获取与搜索查询匹配的标签
fred_series_search_related_tags 获取搜索查询的相关标签
fred_series_updates 获取最近更新的系列
fred_series_vintagedates 获取系列的复古日期

分类

工具 说明
fred_category 获取类别（根=0）
fred_category_children 获取子类别
fred_category_related 获取相关类别
fred_category_series 在类别中获取系列
fred_category_tags 通过以下方式获取类别标签或相关标签 related_to

发布

工具 说明
fred_releases 列出所有版本
fred_releases_dates 获取所有发布的日期
fred_release 获取特定版本
fred_release_dates 获取发布日期
fred_release_series 在发布中获取系列
fred_release_sources 获取发布的来源
fred_release_tags 通过以下方式获取发布标签或相关标签 related_to
fred_release_tables 获取释放表树

来源

工具 说明
fred_sources 列出所有来源
fred_source 获取特定来源
fred_source_releases 获取源代码的发布

标签

工具 说明
fred_tags 列出/搜索所有标签
fred_related_tags 获取相关标签
fred_tags_series 获取系列匹配标签

地图

工具 说明
geofred_series_group 获取地理FRED系列的元数据
geofred_series_data 获取地理序列的横截面区域数据
geofred_regional_data 按系列组获取横断面区域数据
geofred_shapes 获取地理区域边界的GeoJSON形状文件

示例提示

配置后，您可以向Claude询问以下问题：

  • “美国目前的GDP增长率是多少？”（使用 fred_series_search + fred_series_observations)
  • “给我看看过去10年的失业率”（使用 fred_series_observations 随着 observation_start)
  • “本周将发布哪些数据？”（使用 fred_releases_dates)
  • “查找与住房开工相关的所有系列”（使用 fred_series_search)
  • “比较各州的地区失业率”（使用 geofred_regional_data)

发展

git clone https://github.com/floriancaro/fred-mcp-server.git
cd fred-mcp-server
uv sync --dev

# Run unit tests
uv run pytest tests/test_client.py tests/test_tools.py -v

# Run integration tests (requires FRED_API_KEY)
FRED_API_KEY=your-key uv run pytest tests/test_integration.py -v

故障排除

“未设置FRED_API_KEY环境变量” 确保 FRED_API_KEY 在MCP配置中传递 env 在您的shell环境中对其进行阻止或设置。

速率限制 服务器将请求限制为每分钟120次（与FRED API限制相匹配）。如果达到限制，请求将自动等待，无需任何操作。

验证服务器是否正在运行

claude mcp list

贡献

欢迎投稿！请打开问题或提交拉取请求。

许可证

麻省理工学院

相关 MCP