内容
# lit-forge MCP server
[](https://www.npmjs.com/package/lit-forge-mcp)
[](./LICENSE)
[](https://nodejs.org)
**個人資産形成シミュレーション・主要市況スナップショット・経済指標発表予定・中銀高官発言・地政学イベント** を、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 サミットは？」「**今のイラン情勢のヘッドラインは？**」
## 提供ツール（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-USD`。`includeFundamentals: 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 は欠損しやすい |
### 経済イベント・中銀高官発言 & マクロ最新値 — 4 ツール
「**次にいつ発表されるか**」（カレンダー系 2 つ）と「**誰がいつ話すか**」（発言 1 つ）と「**今の数字はいくつか**」（最新値 1 つ）を分担。
| ツール名 | 説明 |
|---|---|
| `get_economic_events_today` | 当日 or 今週の経済イベント（FOMC・日銀金融政策決定会合・米雇用統計・CPI・GDP・米 消費者信頼感指数（CB / ミシガン大）・中国 PMI 等）を重要度付きで返す。`category` で `macro` / `geopolitical` / `policy` に絞り込み可能。期間イベント（ジャクソンホール会議等）は `endDate` で複数日対応。半年分を手動キュレーション。中銀高官の発言は `get_central_bank_speakers` を使用 |
| `get_central_bank_speakers` | **これからの中銀高官の発言・講演をライブ取得**: ForexFactory 無料カレンダーから発言系イベント（FRB 理事・地区連銀総裁・日銀・ECB・BOE 等）を抽出。米 Fed は当年 FOMC 名簿で **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 系列の最新発表値**: 雇用統計・失業率・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_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` を利用します。
## インストール / 設定
### Claude Desktop の場合
`claude_desktop_config.json` に以下を追加します。
```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 の場合
```bash
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 など）を完全終了して再起動**
## ローカル開発
```bash
git clone https://github.com/noblabs/lit-forge-mcp.git
cd lit-forge-mcp
npm install
npm run build
node dist/index.js # stdio で起動
```
### 動作確認
```bash
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"]` で絞り込み）
- 「**今のイラン情勢のヘッドラインは？**」「**ウクライナ和平の最新ニュースは？**」
## 投資判断の免責
本ツールの試算はすべて月次複利による参考値です。実際の運用結果（市場変動・税金・手数料・為替）を保証するものではありません。個別の金融商品の推奨ではなく、**投資判断はご自身の責任**でお願いします。
公的年金額の概算は厚生年金の標準値ベースです。正確な見込み額は[ねんきんネット](https://www.nenkin.go.jp/n_net/)でご確認ください。
## ライセンス
MIT
