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 速報を静的手転記からライブ取得に置換（半年手動更新を廃止）、さらにISM 製造業/非製造業・消費者信頼感（CB/ミシガン大）・ADP 雇用を pulse にライブ追加。発表日は 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 等）をライブ取得し、米 Fed は当年 FOMC 名簿で役職（ダラス連銀総裁等）と投票権の有無を補完。投票メンバーの発言は重要度を引き上げ（議長=★★★ / 投票メンバー=★★以上）。※ v0.17.0 でget_economic_events_todayに一時導入した静的centralbankカテゴリは本ツールに一本化（撤去）。

v0.16.0:get_economic_events_today（手動キュレーション経済カレンダー）に米 消費者信頼感指数（Conference Board・毎月最終火曜）とミシガン大消費者態度指数（速報=第 2 金曜 / 確報=第 4 金曜）を追加。為替で注目度の高い米消費マインド系をカバー。

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 との対話のなかで、たとえば次のような問いを 1 ターンで返せます:

- 「老後資金、足りる？」「月いくら積み立てれば 2,000 万円届く？」
- 「今日の市況を 28 指標で要約して」「セクターでどこが強い？」
- 「次の雇用統計はいつ？」「今月の FRB 発表予定をまとめて」
- 「直近の CPI と PPI の前年同月比は？」「コア CPI とコア PPI を比較して」
- 「今月の G7 サミットは？」「今のイラン情勢のヘッドラインは？」

つみたて NISA / iDeCo / 退職プランニング向けの月次複利シミュレーション群。

「次にいつ発表されるか」（カレンダー系 2 つ）と「誰がいつ話すか」（発言 1 つ）と「今の数字はいくつか」（最新値 1 つ）を分担。

市況・分析・個別株系ツールは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 リクエストを送信します。実行 PC のネットワークから外部に出る通信が発生する点にご留意ください。

データは数十分〜1 時間遅れの参考値で、投資助言ではなく情報集約として提供しています。

get_quoteの fundamentals /get_dividend_history/get_analyst_consensusは Yahoo Finance v10 quoteSummary（crumb 認証あり）を経由するため、依存パッケージとしてyahoo-finance2を利用します。

{ "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 mcp add lit-forge -- npx -y lit-forge-mcp@latest

~/.cursor/mcp.json（または プロジェクト直下の.cursor/mcp.json）に同じ JSON を追加します。

上記の設定例ではいずれもlit-forge-mcp@latestを指定しています。これはnpxのキャッシュ挙動により、バージョン指定なしの場合に古いキャッシュ版が使われ続けることがあるためです。@latestを指定すると、起動時に npm registry の最新タグを毎回確認して取得します（バージョン解決のオーバーヘッドはわずか）。

すでにlit-forge-mcp（バージョン指定なし）で運用中の方は、新機能・バグ修正を取り込むために以下のいずれかをお試しください:
- 設定をlit-forge-mcp@latestに変更（恒久対応、推奨）
- npx キャッシュをクリア:npx clear-npx-cacheまたは手動で~/.npm/_npx/を削除
- 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

- 「私は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"]で絞り込み）
- 「今のイラン情勢のヘッドラインは？」「ウクライナ和平の最新ニュースは？」

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

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

Programmatically manage Visual Studio Code settings using AI assistants and automated tools.