经济情报MCP
Ask your AI about the economy — interest rates, jobs, inflation, housing, bank health.
Interactive app with cross-source analysis from FRED, BLS, Treasury, and FDIC data.
______________________________________________________________________
快速开始
1.克隆仓库
git clone https://github.com/thinkchainai/economic-intelligence-mcp.git
cd economic-intelligence-mcp2.双击 .mcpb 文件
打开 economic-intelligence-mcp.mcpb --Claude Desktop将提示您安装它。
3.添加您的FRED API密钥
获取免费密钥 （30秒）：https://fred.stlouisfed.org/docs/api/api_key.html
Claude Desktop将在安装过程中要求它：
4.配置权限
服务器有1个交互式工具(open_economic_app)以及12个只读数据工具：
5.启用连接器
6.打开经济应用程序
只需键入“打开经济学应用程序”，Claude将启动交互式仪表板：
该应用程序有利率、通货膨胀、就业、住房、GDP、财政、银行、比较和搜索的标签导航，所有这些都有实时数据和交互式图表。
其他要尝试的事情：
“显示过去5年的利率” “将失业率与通货膨胀率进行比较” “现在有任何经济警报吗？” “过去6个月，收益率曲线信号发生了怎样的变化？”
______________________________________________________________________
13工具
交互式应用程序（1个工具）
| 工具 | 它做什么 |
|---|---|
open_economic_app | 打开交互式仪表板——图表、衰退指标、信号、数据浏览器 |
实时数据（9个工具）
| 工具 | 它做什么 |
|---|---|
econ_interest_rates | 联邦基金、10年/30年期国债、抵押贷款利率、收益率曲线 |
econ_inflation | CPI、PCE、核心通胀与同比分析 |
econ_jobs | 失业、非农就业、工资增长、职位空缺 |
econ_housing | 住房开工、许可证、房价、负担能力指数 |
econ_bank_health | FDIC资本比率、问题银行、破产历史 |
econ_gdp | 国内生产总值增长----名义、实际、年化 |
econ_treasury | 国债利率、收益率差、联邦债务 |
econ_compare | 用相关性分析比较任意两个FRED系列 |
econ_search | 按关键字搜索800K+FRED系列 |
状态智能（3个工具）
这些工具使用本地SQLite数据库来跟踪信号随时间的变化。在第一次运行时，服务器会回填12个月的信号历史记录，以便它们立即工作。
| 工具 | 它做什么 |
|---|---|
econ_signal_history | 几个月来，收益率曲线、就业/通胀和银行压力信号如何变化 |
econ_changes | 最近发生了什么变化——将最新信号与之前的快照进行比较 |
econ_alerts | 阈值跨越、趋势逆转、衰退概率转移 |
______________________________________________________________________
跨来源情报
这不仅仅是一个API包装器。服务器将来自多个政府来源的数据组合在一起，并计算：
- 收益率曲线反转 --10Y-2Y价差分析，历史上最好的衰退预测指标
- 就业与通胀差异 --过热、滞胀和goldilocks检测
- 住宅负担能力指数 --房价×抵押贷款利率×收入综合指数
- 银行压力评分 --FDIC问题银行数量+破产趋势
- 综合衰退概率 --来自所有来源的加权信号
信号历史和警报
服务器在轻量级本地数据库中跟踪其自己的计算信号随时间的变化(~/.economic-mcp/data.db).在首次启动时，它通过对历史FRED数据运行评分算法来回填12个月的历史信号数据。之后，它每6小时刷新一次。
这使得其他MCP服务器无法回答的问题成为可能：
- “过去6个月，经济衰退的可能性发生了怎样的变化？”
- “本周是否有任何信号越过临界阈值？”
- “收益率曲线趋势是否正在逆转？”
Government APIs → Scoring Engine → Signal Snapshots → MCP Tools → Claude Desktop
↓ ↓ ↓ ↓
FRED Yield curve Local SQLite Interactive app
BLS Jobs/inflation 12mo backfill Charts & gauges
Treasury Bank stress 6hr refresh Alert detection
FDIC Recession prob. Change tracking______________________________________________________________________
数据源
所有免费的政府API都有慷慨的费率限制：
| 来源 | 内容 | 授权 |
|---|---|---|
| 弗雷德 | 800K+经济系列-GDP、CPI、失业率、利率、住房 | 免费API密钥 |
| 美国劳工统计局 | 就业、工资、按地铁和行业划分的CPI | 免费API密钥（可选） |
| 财政部 | 每日利率、联邦债务、债券拍卖 | 无 |
| 联邦储蓄保险公司 | 银行健康状况、资本比率、破产历史 | 无 |
______________________________________________________________________
重建 .mcpb
如果您修改了源代码或需要更新env-var-config：
./build-mcpb.sh这运行 npx @anthropic-ai/mcpb pack 并输出一个新鲜的 economic-intelligence-mcp.mcpb 在repo根目录中。双击以重新安装。
______________________________________________________________________
替代方案：从源代码运行
如果您不想使用 .mcpb 文件：
# Install
pip install -e .
# Set your API key
export FRED_API_KEY=your_key_here
# Run the server
economic-intelligence-mcp然后添加到您的Claude Desktop配置中(~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"economic-intelligence": {
"command": "economic-intelligence-mcp",
"env": {
"FRED_API_KEY": "your_key_here"
}
}
}
}______________________________________________________________________
托管版本
不想管理API密钥或在本地运行？
mcpbundles.com --相同的工具，零设置。数据始终是最新的。
______________________________________________________________________
贡献
欢迎PR——bug修复、新的评分算法、新的数据源、UI改进。
git clone https://github.com/thinkchainai/economic-intelligence-mcp.git
cd economic-intelligence-mcp
pip install -e ".[dev]"______________________________________________________________________
许可证
麻省理工学院——见 许可证.
由...建造 MCP捆绑包.