lit-forge-mcp

lit-forge MCP 服务

个人资产积累模拟、主要市场行情快照、经济指标发布时间表、央行官员发言、地缘政治事件，这是一个可由 AI 直接调用的 Model Context Protocol（MCP）stdio 服务（19 个工具）。

可在 Claude Desktop / Claude Code / Cursor 等任意兼容 MCP 的 AI 客户端中运行。

最新版本亮点（v0.20.0）：为 get_economic_release_pulse 新增 ForexFactory 实时适配器。通过动态获取新增 美国 JOLTS 职位空缺数（此前因 PFEI 未收录而遗漏），并将 S&P Global PMI 初值从静态手动转录替换为实时获取（不再需要每半年手动更新）；此外，还在 pulse 中实时新增 ISM 制造业/非制造业、消费者信心指数（CB/密歇根大学）、ADP 就业数据。发布日期通过运行时获取 faireconomy 每周日历 XML，无需手动补充未来日期。GMT→JST 转换可准确处理跨日情况。※ BLS 三大指标（就业统计、CPI、PPI）仍以官方一手来源 PFEI 为准。

v0.19.0：为 get_economic_release_pulse 新增 美国人口普查局（U.S. Census Bureau）的 Advance Economic Indicators Report（批发库存、零售库存、货物贸易差额的初值，每月 08:30 ET），填补了此前所有适配器都未能覆盖的「美国批发库存【初值】」等数据缺口。发布日期通过运行时实时获取官方发布日历（List View），因此可随官方页面更新追踪次年及以后的日程（无需手动更新）。

v0.18.0：新增工具 get_central_bank_speakers。从 ForexFactory 免费日历实时获取未来央行官员的发言和演讲（FRB 理事、地区联储行长、日本银行、ECB、BOE 等），并通过当年 FOMC 名单补充美国 Fed 官员的职务（如达拉斯联储行长）和是否拥有投票权。提高投票成员发言的重要性（主席=★★★ / 投票成员=★★以上）。※ v0.17.0 中临时加入 get_economic_events_today 的静态 centralbank 类别已统一至本工具（并已移除）。

v0.16.0：为 get_economic_events_today（手动整理的经济日历）新增 美国消费者信心指数（Conference Board・每月最后一个星期二）和 密歇根大学消费者信心指数（初值=第二个星期五 / 终值=第四个星期五）。覆盖外汇市场关注度较高的美国消费信心数据。

v0.15.0：为 get_economic_release_pulse 新增 DOL/ETA 初次申请失业救济人数（每周发布・每周四 08:30 ET）和 S&P Global 美国 PMI 初值（制造业/服务业 flash，09:45 ET），填补了此前遗漏的数据覆盖缺口。

v0.14.0：整合白宫 OMB/OIRA 的 PFEI (Principal Federal Economic Indicators) Schedule，实现 BLS 三大指标（就业统计、CPI、PPI）的发布日期自动获取。同时将 get_us_macro_latest 从 4 个系列扩展到 7 个系列（新增核心 CPI / 核心 PPI / 平均时薪）。

与 Claude / GPT / Cursor 对话时，例如可以在一轮对话中获得以下问题的回答：

-「养老资金够吗？」「每月要存多少钱才能攒到 2,000 万日元？」 -「用 28 项指标总结今天的市场行情」「哪些行业表现强劲？」 -「下一次就业统计什么时候发布？」「汇总本月 FRB 的发布日程」 -「最近的 CPI 和 PPI 同比是多少？」「比较核心 CPI 和核心 PPI」 -「本月的 G7 峰会是什么时候？」「当前伊朗局势的头条新闻是什么？」

提供的工具（18 种）

个人资产积累规划工具（纯函数，无需外部 API） — 4 个工具

面向つみたて NISA / iDeCo / 退休规划的月度复利模拟工具集。

工具名	说明
simulate_nisa	根据每月投资金额、预期年利率和年限，按月复利估算评估金额、投资收益和年度变化
plan_retirement	根据年龄、储蓄、收入、预期生活费、风险承受能力和养老金，通过乐观/现实/悲观 3 种情景诊断养老资金充足度，并反推所需月存金额
calculate_required_monthly	根据目标金额、当前储蓄、年利率和年限，反推出达成目标所需的每月投资金额
calculate_compound_interest	使用按月复利计算一次性本金和每月定投金额的通用复利计算工具

市场行情快照与个股 — 2 个工具

工具名	说明
get_market_snapshot	一次性获取 USD/JPY・EUR/JPY・GBP/JPY・AUD/JPY・EUR/USD・CHF/JPY・美元指数・日经平均指数・TOPIX・纽约道琼斯指数・S&P 500・NASDAQ・VIX・NYSE FANG+・SOX・DAX・FTSE・上证综合指数・恒生指数・KOSPI・SENSEX・美国 10 年/5 年期利率・黄金・原油・铜・比特币・以太坊等主要 28 项指标
get_quote	获取任意 Yahoo Finance 代码（股票、外汇、指数、大宗商品、加密资产）的当前价格和较前一日涨跌。示例：AAPL / ^DJI / BTC-USD。设置 includeFundamentals: true 还可同时获取 PER / PBR / 股息率 / 贝塔 / 市值

市场行情概览 — 5 个工具

工具名	说明
get_market_thermometer	综合 VIX、S&P 500、美国 10 年期利率和美元指数，得出 0-100 的风险偏好/避险评分 + 过去 30 个交易日的走势
get_performance_ranking	按 1d/1w/1m 的表现对 28 个标的排序，并返回前 N 项/后 N 项
get_yield_spread	美国 10 年期与 5 年期收益率利差（正值=正向收益率曲线 / 负值=倒挂收益率曲线）
get_market_sessions	主要 4 个市场（东京、上海、伦敦、纽约）当前的交易时段状态（open / pre-open / closed / holiday，支持节假日）
get_sector_heatmap	美国股票板块 ETF（SPDR，11 个板块）的较前一日涨跌幅列表

个股深度分析 — 2 个工具

工具名	说明
get_dividend_history	获取个股和 ETF 过去 N 年的股息记录及日历年度合计（years：1/3/5/10，默认 5）。可作为在 NISA 成长投资额度中考虑股息股票时的一手信息
get_analyst_consensus	获取个股分析师评级（强烈买入至强烈卖出）、目标股价（平均/最高/最低）和按月划分的评级明细。美国股票的数据覆盖较广，TSE 股票和 ETF 则较容易缺失

经济事件・央行官员讲话 & 宏观最新数据 — 4 个工具

分别负责“下次何时公布”（2 个日历类）、“谁何时发言”（1 个讲话类）和“当前数据是多少”（1 个最新数据类）。

工具名称	说明
get_economic_events_today	返回当天或本周的经济事件（FOMC、日本银行货币政策会议、美国就业报告、CPI、GDP、美国消费者信心指数（CB / 密歇根大学）、中国 PMI 等），并标注重要程度。可通过 category 筛选 macro / geopolitical / policy。可通过 endDate 支持持续多日的事件（如杰克逊霍尔会议）。人工整理半年份数据。央行官员讲话请使用 get_central_bank_speakers
get_central_bank_speakers	实时获取即将举行的央行官员讲话和演讲：从 ForexFactory 免费日历中提取讲话类事件（美联储理事、地区联储主席、日本银行、ECB、BOE 等）。根据当年 FOMC 名单为美国 Fed 补充 role（如达拉斯联储主席）/ votingMember（是否有投票权），并提高投票成员的重要程度（主席=★★★ / 投票成员=★★以上）。可通过 range（today/week）和 countries（US/JP/EU/GB/CN/OTHER）筛选。缓存 6 小时
get_economic_release_pulse	实时获取官方机构的预定发布信息：并行获取 BEA / NY 联储 / FRB / BLS（通过 PFEI） / DOL/ETA（首次申请失业保险人数） / ForexFactory 实时数据（JOLTS 职位空缺数、制造业/服务业 PMI 初值、ISM 制造业/非制造业、消费者信心〔CB/密歇根大学〕、ADP 就业） / 人口普查局（批发库存、零售库存、货物贸易差额初值） / 内阁府 / 日本银行的日历，汇总并返回今天、本周和本月的经济指标发布计划。BLS 三大指标于 v0.14.0 集成 PFEI Schedule，人口普查局 Advance Economic Indicators 于 v0.19.0 加入，v0.20.0 新增 ForexFactory 实时适配器（加入 JOLTS、实现 S&P PMI 初值实时获取，并加入 ISM/消费者信心/ADP）
get_us_macro_latest	美国 7 项宏观数据系列的最新公布值：通过 BLS Public Data API v2 一次请求获取就业报告、失业率、CPI、核心 CPI、PPI、核心 PPI 和平均时薪。返回数值 + 环比 + 同比。无需 API key・无需认证，每天 25 次请求・缓存 6 小时

地缘政治 — 2 个工具

分为已确定日程（日历）和实时快讯（脉冲）两类。

工具名称	说明
get_geopolitical_calendar	已确定的官方日程：按 4 个子类别（summit / bilateral / election / risk）返回今天、本周和本月的地缘政治事件。包含 marketImplications / participants / sourceUrl。静态数据，每半年通过 PR 手动更新一次
get_geopolitical_pulse	实时快讯：并行获取 BBC World・Al Jazeera・Google News（主题搜索）的 RSS，按最新顺序返回正在发生的地缘政治事件（首脑会谈、冲突、制裁、封锁情景等）。topic：us-china / middle-east / ukraine / japan / global。仅提供文章元数据（标题、发布方、发布时间、URL），由调用方的大模型负责解读

关于 HTTP 通信

市况、分析和个股类工具会向 Yahoo Finance API（query1.finance.yahoo.com / query2.finance.yahoo.com） 发送请求，get_us_macro_latest 会向 BLS Public Data API v2（api.bls.gov） 发送请求，get_economic_release_pulse 会向 各官方机构的日历页面发送请求，get_geopolitical_pulse 会向 BBC / Al Jazeera / Google News 的 RSS 发送请求，get_central_bank_speakers 会向 ForexFactory 免费日历（nfs.faireconomy.media） 发送 HTTPS 请求。请注意，运行本程序的电脑会通过网络向外部发送请求。

数据可能延迟数十分钟至 1 小时，仅作为参考值提供，用于信息汇总，并非投资建议。

get_quote 的 fundamentals / get_dividend_history / get_analyst_consensus 会通过 Yahoo Finance v10 quoteSummary（需 crumb 认证），因此会使用依赖包 yahoo-finance2。

安装 / 配置

Claude Desktop

将以下内容添加到 claude_desktop_config.json。

{
  "mcpServers": {
    "lit-forge": {
      "command": "npx",
      "args": ["-y", "lit-forge-mcp@latest"]
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add lit-forge -- npx -y lit-forge-mcp@latest

Cursor

将相同的 JSON 添加到 ~/.cursor/mcp.json（或项目根目录下的 .cursor/mcp.json）。

💡 关于指定 @latest

上述配置示例均指定了 lit-forge-mcp@latest。这是因为 npx 的缓存机制可能会导致在未指定版本时持续使用旧缓存版本。指定 @latest 后，每次启动时都会检查并获取 npm registry 中的最新标签（版本解析的开销很小）。

如果你目前使用 lit-forge-mcp（未指定版本），请尝试以下任一方法以获取新功能和错误修复：

1. 将配置改为 lit-forge-mcp@latest（永久解决方案，推荐）
2. 清除 npx 缓存：运行 npx clear-npx-cache，或手动删除 ~/.npm/_npx/
3. 完全退出并重新启动 MCP 客户端（如 Claude Desktop）

本地开发

git clone https://github.com/noblabs/lit-forge-mcp.git
cd lit-forge-mcp
npm install
npm run build
node dist/index.js   # stdio で起動

验证运行情况

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0.0.1"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | node dist/index.js

如果 tools/list 的响应中列出了 18 个工具，即表示成功。

使用例

Claude にこんな依頼ができます:

資産形成プランニング

• 「私は35歳で月3万を積立中。現在の貯蓄500万、退職65歳、月の希望生活費25万。老後資金足りる？」
• 「20年で2000万作りたい。今500万あって年利4%なら毎月いくら積み立てればいい？」
• 「100万円を年利5%で30年複利運用したらいくらになる？」
• 「月3万円を年利6%で20年積み立てたら？」

市況スナップショット

• 「今日の市況を要約して」「主要指標の前日比を表で見せて」
• 「米10年金利と日経平均の動きから、今のリスクオン度合いをコメントして」
• 「BTC-USD の今の値は？」「ポンド円（GBPJPY=X）を教えて」

個別株の深掘り

• 「KO の過去 10 年の配当推移を見せて」「VYM の年次配当合計は？」
• 「NVDA のアナリスト目標株価と推奨レーティングは？」
• 「AAPL の PER / PBR / 配当利回り / ベータをまとめて」（get_quote で includeFundamentals=true）

経済指標カレンダー & 最新値

• 「今週の経済イベントは？特に FOMC や日銀の予定を教えて」
• 「次の雇用統計はいつ？」「今月の FRB と内閣府の発表予定をまとめて」
• 「直近の CPI と PPI を前月比・前年同月比で」「コア CPI とコア PPI を比較して」

中銀高官の発言

• 「今日の Fed 要人発言は？投票権ありの人だけ教えて」「今週の中銀スピーカー一覧」（get_central_bank_speakers）
• 「今週ラガルド ECB 総裁や日銀の発言予定はある？」（countries=["EU","JP"] で絞り込み）

地政学イベント

• 「今週の地政学イベントは？」「今月の G7 サミットの予定は？」
• 「次の米中首脳会談はいつ？」「日本に関係する首脳会談だけ抽出して」（country=["JP"] で絞り込み）
• 「今のイラン情勢のヘッドラインは？」「ウクライナ和平の最新ニュースは？」

投資判断の免責

本ツールの試算はすべて月次複利による参考値です。実際の運用結果（市場変動・税金・手数料・為替）を保証するものではありません。個別の金融商品の推奨ではなく、投資判断はご自身の責任でお願いします。

公的年金額の概算は厚生年金の標準値ベースです。正確な見込み額はねんきんネットでご確認ください。

ライセンス

MIT