AI导哈

经济数据分析服务器

FRED MCP Server是一个通过模型上下文协议访问和分析联邦储备经济数据(FRED)的服务，提供经济指标检索、趋势分析和比较功能。

  • by milind-kulshrestha
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 milind-kulshrestha/fred_mcp_server

使用说明

FRED MCP服务器

https://github.com/user-attachments/assets/059030bf-141b-4399-99aa-a2cd51abdf05

用于访问和分析美联储经济数据（FRED）的模型上下文协议（MCP）服务器。

概述

该服务器通过模型上下文协议使用FRED API提供对联邦储备经济数据（FRED）的访问。

特性

  • 经济数据访问：从FRED检索经济指标和时间序列数据
  • 趋势分析：分析一段时间内的经济趋势
  • 比较分析：比较多个经济指标
  • 元数据访问：获取有关可用经济系列的信息
  • 提示模板：使用预定义的提示模板执行常见的经济分析任务

安装

先决条件

  • Python 3.10或更高版本
  • FRED API密钥（用于后端服务）

从源代码安装

# Clone the repository
git clone https://github.com/yourusername/fred-mcp-server.git
cd fred-mcp-server

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package
# Install with pip
pip install .

# Install with UV (recommended for exact dependency versions)
uv pip install .

配置

可以使用环境变量配置服务器：

  • FRED_API_KEY：您的FRED API密钥（必需）
  • LOG_LEVEL：日志记录级别（默认值：“INFO”）
  • LOG_FILE：日志文件路径（默认：“fred_mcp_server.Log”）

用法

运行服务器

# Run directly
python -m fred_mcp_server

# Or using the installed script
fred-mcp

使用Claude for Desktop

要与Claude for Desktop一起使用，请将此服务器添加到您的Claude配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "fred": {
      "command": "uv",
      "args": [
        "run",
        "-m",
        "fred_mcp_server"
      ],
      "cwd": "<PATH_TO_FRED_MCP_SERVER>/src",
      "env": {
        "FRED_API_KEY": "your_fred_api_key_here"
      }
    }
  }
}

笔记：

  • 替换 <PATH_TO_FRED_MCP_SERVER> 带有fred目录的绝对路径
  • 您可以使用 "command": "uv" 随着 "args": ["run", "-m", "fred_mcp_server"] 如果使用uv包管理器

注： 替换 your_fred_api_key_here 使用您的实际FRED API密钥。您可以通过在注册获得免费的API密钥https://fred.stlouisfed.org/docs/api/api_key.html

可用工具

所有工具都使用一致的 fred_ 用于清除命名空间管理的前缀：

  • search_fred_series：按关键字或类别搜索经济数据系列
  • fred_get_series_data：检索特定经济指标的时间序列数据
  • fred_get_series_metadata：获取特定经济数据系列的详细元数据
  • fred_get_category_series：列出特定FRED类别中的系列
  • fred_get_releases：从FRED获取经济数据发布
  • fred_compare_series：比较指定时间段内的多个经济指标
  • fred_calculate_statistics：计算FRED系列的基本统计数据
  • fred_detect_trends：确定FRED经济数据的趋势
  • analyze_economic_trends：分析经济指标随时间的变化趋势

可用提示

  • economic-data-search：如何有效搜索经济指标
  • data-visualization-guide：如何创建和解释经济数据可视化
  • trend-analysis-guide：如何分析经济指标的趋势
  • comparative-analysis：如何对经济指标进行比较分析
  • latest-data-analysis：如何分析最新的经济指标

FRED API免责声明

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

许可证

麻省理工学院

相关 MCP