经济智能分析工具

一款交互式经济数据分析工具,整合FRED、BLS、Treasury和FDIC等多源数据,提供利率、就业、通胀、住房和银行健康等经济指标的实时分析与可视化。

  • by thinkchainai
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 thinkchainai/economic-intelligence-mcp

使用说明

经济情报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-mcp

2.双击 .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捆绑包.