Skip to content

noblabs/lit-forge-mcp

Repository files navigation

lit-forge MCP server

npm version license node

個人資産形成シミュレーション・主要市況スナップショット・経済指標発表予定・地政学イベント を、AI から直接呼び出せる Model Context Protocol(MCP)の stdio サーバーです(18 ツール)。

Claude Desktop / Claude Code / Cursor など、MCP に対応した任意の AI クライアントで動作します。

最新版ハイライト(v0.15.0): get_economic_release_pulseDOL/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 サミットは?」「今のイラン情勢のヘッドラインは?

提供ツール(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・NY ダウ・S&P 500・NASDAQ・VIX・NYSE FANG+・SOX・DAX・FTSE・上海総合・ハンセン・KOSPI・SENSEX・米10年/5年金利・金・原油・銅・ビットコイン・イーサリアム の主要 28 指標を一括取得
get_quote 任意の Yahoo Finance ティッカー(株・為替・指数・コモディティ・暗号資産)の現在値・前日比を取得。例: AAPL / ^DJI / BTC-USDincludeFundamentals: true で PER / PBR / 配当利回り / ベータ / 時価総額も併せて取得

市況俯瞰 — 5 ツール

ツール名 説明
get_market_thermometer VIX・S&P 500・米10年金利・ドル指数を合成した 0-100 のリスクオン/オフ・スコア + 過去 30 営業日推移
get_performance_ranking 28 銘柄を 1d/1w/1m のパフォーマンスでソート、上位/下位 N 件を返す
get_yield_spread 米10年-5年イールドスプレッド(プラス=順イールド / マイナス=逆イールド)
get_market_sessions 主要 4 市場(東京・上海・ロンドン・NY)の現在の取引時間ステータス(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 個別株のアナリスト推奨レーティング(強気買い〜強気売り)・目標株価(平均/高値/安値)・月別推奨内訳を取得。米国株は coverage が厚く、TSE 銘柄や ETF は欠損しやすい

経済イベント & マクロ最新値 — 3 ツール

次にいつ発表されるか」(カレンダー系 2 つ)と「今の数字はいくつか」(最新値 1 つ)を分担。

ツール名 説明
get_economic_events_today 当日 or 今週の経済イベント(FOMC・日銀金融政策決定会合・米雇用統計・CPI・GDP・中国 PMI 等)を重要度付きで返す。categorymacro / policy に絞り込み可能。期間イベント(ジャクソンホール会議等)は endDate で複数日対応。半年分を手動キュレーション
get_economic_release_pulse 公式機関の発表予定を実取得: BEA / NY 連銀 / FRB / BLS(PFEI 経由) / DOL/ETA(新規失業保険申請件数) / S&P Global(製造業・サービス業 PMI 速報) / 内閣府 / 日銀 のカレンダーを並列取得し、本日・今週・今月の経済指標リリース予定を統合して返す。BLS 三大指標は v0.14.0 で PFEI Schedule 統合、DOL/ETA・S&P Global は v0.15.0 で追加(前者は木曜計算 + 祝日補正、後者は公式カレンダー手転記)
get_us_macro_latest 米マクロ 7 系列の最新発表値: 雇用統計・失業率・CPI・コア CPI・PPI・コア PPI・平均時給 を BLS Public Data API v2 から 1 リクエストで取得。値 + 前月比 + 前年同月比を返す。API key 不要・無認証 1 日 25 リクエスト・6 時間キャッシュ

地政学 — 2 ツール

確定スケジュール(カレンダー)とリアルタイム速報(パルス)の 2 系統。

ツール名 説明
get_geopolitical_calendar 確定済み公式スケジュール: 本日・今週・今月の地政学イベントを 4 サブカテゴリ(summit / bilateral / election / risk)で返す。marketImplications / participants / sourceUrl 付き。半年に 1 回 PR で手動更新の静的データ
get_geopolitical_pulse リアルタイム速報: BBC World・Al Jazeera・Google News(トピック検索)の RSS を並列取得し、進行中の地政学イベント(首脳会談・紛争・制裁・封鎖シナリオ等)を最新順で返す。topic: us-china / middle-east / ukraine / japan / global。記事メタデータ(タイトル・配信元・配信日時・URL)のみで、解釈は呼び出し側 LLM の責務

HTTP 通信について

市況・分析・個別株系ツールは Yahoo Finance API(query1.finance.yahoo.com / query2.finance.yahoo.com) へ、get_us_macro_latestBLS Public Data API v2(api.bls.gov) へ、get_economic_release_pulse各公式機関のカレンダーページへ、get_geopolitical_pulseBBC / Al Jazeera / Google News の RSS へ HTTPS リクエストを送信します。実行 PC のネットワークから外部に出る通信が発生する点にご留意ください。

データは数十分〜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 の場合

~/.cursor/mcp.json(または プロジェクト直下の .cursor/mcp.json)に同じ 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_quoteincludeFundamentals=true

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

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

地政学イベント

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

投資判断の免責

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

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

ライセンス

MIT

About

MCP server (18 tools): NISA/iDeCo/retirement simulation, 28-indicator market snapshot, individual stock fundamentals (dividend/analyst), economic release calendars from 6 official sources (BEA/NY Fed/FRB/BLS/Cabinet Office/BOJ), latest BLS macro values (7 series), and geopolitical calendar + pulse.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors