经济数据访问服务器

一个强大的模型上下文协议(MCP)服务器,通过Claude和其他MCP兼容客户端提供对联邦储备经济数据(FRED)的访问。

  • by satendra-mani-tiwari
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 satendra-mani-tiwari/fred-economic-mcp-server

使用说明

FRED经济MCP服务器

一个强大的模型上下文协议(MCP)服务器,通过Claude和其他兼容MCP的客户端提供对美联储经济数据(FRED)的访问。

🌟 特性

  • 📊 全面的数据访问:访问800000+经济时间序列
  • 🔍 智能搜索:按关键字或类别查找经济指标
  • 📈 历史分析:每个系列最多检索100000个观测值
  • ⚡ 高性能:具有适当错误处理的高效异步操作
  • 🎯 经济仪表盘:预先配置的关键经济指标
  • 🔄 多系列支持:同时比较多个经济序列

🚀 快速开始

先决条件

  • Python 3.8或更高版本
  • FRED API密钥(免费 弗雷德)

安装

  1. 下载服务器文件:

    • 下载 fred_economic_server.py 来自此存储库
  2. 安装依赖项:

pip install httpx python-mcp python-dotenv
  1. 获取FRED API密钥:

  2. 设置环境:

export FRED_API_KEY="your_api_key_here"

使用Claude Desktop

添加到您的Claude Desktop配置(claude_desktop_config.json):

{
  "mcpServers": {
    "fred-economic": {
      "command": "python",
      "args": ["path/to/fred_economic_server.py"],
      "env": {
        "FRED_API_KEY": "your_api_key_here"
      }
    }
  }
}

🛠️ 可用工具

工具 说明 示例用法
get_fred_data 按序列ID获取经济数据 GDP、失业率、通货膨胀
get_fred_historical 检索4年以上的数据 长期趋势分析
search_fred 按关键字查找系列 搜索“房价”
fred_dashboard 主要经济指标 国内生产总值、失业率、利率
get_multiple_series 比较多个系列 GDP与失业率

📊 查询示例

基础数据检索

Ask Claude: "Get the latest GDP data"
Uses: get_fred_data("GDP")

历史分析

Ask Claude: "Show me 10 years of unemployment data"
Uses: get_fred_historical("UNRATE", years=10)

经济研究

Ask Claude: "Compare inflation and unemployment over the last 5 years"  
Uses: get_multiple_series(["CPIAUCSL", "UNRATE"])

📈 普通经济系列

指标 系列ID 描述
国内生产总值 GDP 国内生产总值
失业 UNRATE 失业率
通货膨胀 CPIAUCSL 消费者价格指数
联邦基金利率 FEDFUNDS 联邦基金利率
10年期国债 DGS10 10年期国债利率
标准普尔500指数 SP500 标准普尔500指数

📞 支持

  • 📧 问题:使用GitHub Issues进行错误报告和功能请求
  • 📖 FRED API单据: https://fred.stlouisfed.org/docs/api/
  • 🔧 MCP协议: https://modelcontextprotocol.io/

📄 许可证

该项目根据MIT许可证获得许可。