使用说明
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许可证获得许可。
