FRED经济MCP服务器
一个强大的模型上下文协议（MCP）服务器，通过Claude和其他兼容MCP的客户端提供对美联储经济数据（FRED）的访问。
🌟 特性
- 📊 全面的数据访问：访问800000+经济时间序列
- 🔍 智能搜索：按关键字或类别查找经济指标
- 📈 历史分析：每个系列最多检索100000个观测值
- ⚡ 高性能：具有适当错误处理的高效异步操作
- 🎯 经济仪表盘：预先配置的关键经济指标
- 🔄 多系列支持：同时比较多个经济序列
🚀 快速开始
先决条件
- Python 3.8或更高版本
- FRED API密钥（免费 弗雷德)
安装
- 下载服务器文件：
- 下载 fred_economic_server.py 来自此存储库
- 安装依赖项：
pip install httpx python-mcp python-dotenv- 获取FRED API密钥：
- 访问 FRED API密钥注册 - 注册一个免费帐户 - 生成API密钥
- 设置环境：
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许可证获得许可。
______________________________________________________________________