lit-forge-mcp 0.14.0 → 0.14.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +51 -25
- package/package.json +5 -2
package/README.md
CHANGED
|
@@ -4,15 +4,25 @@
|
|
|
4
4
|
[](./LICENSE)
|
|
5
5
|
[](https://nodejs.org)
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
**個人資産形成シミュレーション・主要市況スナップショット・経済指標発表予定・地政学イベント** を、AI から直接呼び出せる Model Context Protocol（MCP）の stdio サーバーです（**18 ツール**）。
|
|
8
8
|
|
|
9
9
|
Claude Desktop / Claude Code / Cursor など、MCP に対応した任意の AI クライアントで動作します。
|
|
10
10
|
|
|
11
|
-
>
|
|
11
|
+
> **最新版ハイライト（v0.14.0）**: ホワイトハウス OMB/OIRA の **PFEI (Principal Federal Economic Indicators) Schedule** を統合し、BLS 三大指標（雇用統計・CPI・PPI）の **発表予定** が自動取得対応に。あわせて `get_us_macro_latest` を 4 → 7 系列へ拡張（コア CPI / コア PPI / 平均時給を追加）。
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
Claude / GPT / Cursor との対話のなかで、たとえば次のような問いを 1 ターンで返せます:
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
- 「老後資金、足りる？」「月いくら積み立てれば 2,000 万円届く？」
|
|
16
|
+
- 「今日の市況を 28 指標で要約して」「セクターでどこが強い？」
|
|
17
|
+
- 「**次の雇用統計はいつ？**」「**今月の FRB 発表予定をまとめて**」
|
|
18
|
+
- 「**直近の CPI と PPI の前年同月比は？**」「**コア CPI とコア PPI を比較して**」
|
|
19
|
+
- 「今月の G7 サミットは？」「**今のイラン情勢のヘッドラインは？**」
|
|
20
|
+
|
|
21
|
+
## 提供ツール（18 種）
|
|
22
|
+
|
|
23
|
+
### 個人資産形成プランナー（純関数、外部 API 不要） — 4 ツール
|
|
24
|
+
|
|
25
|
+
つみたて NISA / iDeCo / 退職プランニング向けの月次複利シミュレーション群。
|
|
16
26
|
|
|
17
27
|
| ツール名 | 説明 |
|
|
18
28
|
|---|---|
|
|
@@ -21,44 +31,56 @@ Claude Desktop / Claude Code / Cursor など、MCP に対応した任意の AI
|
|
|
21
31
|
| `calculate_required_monthly` | 目標金額・現在の貯蓄・年利・年数から、達成に必要な毎月の積立額を逆算 |
|
|
22
32
|
| `calculate_compound_interest` | 元本（一括）と月次積立を月次複利で評価する汎用複利計算ツール |
|
|
23
33
|
|
|
24
|
-
###
|
|
34
|
+
### 市況スナップショット & 個別銘柄 — 2 ツール
|
|
25
35
|
|
|
26
36
|
| ツール名 | 説明 |
|
|
27
37
|
|---|---|
|
|
28
38
|
| `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 指標を一括取得 |
|
|
29
|
-
| `
|
|
30
|
-
| `get_geopolitical_calendar` | **v0.9.0 で `get_geopolitical_events` からリネーム**。**確定済み公式スケジュール専用**: 本日・今週・今月の地政学イベントを 4 サブカテゴリ（summit / bilateral / election / risk）で返す。`marketImplications` / `participants` / `sourceUrl` 付き。半年に 1 回 PR で手動更新の静的データ。進行中の地政学リスクは `get_geopolitical_pulse` を使用 |
|
|
31
|
-
| `get_geopolitical_pulse` | **v0.9.0 新規**。**リアルタイム速報**: BBC World・Al Jazeera・Google News（トピック検索）の RSS を並列取得し、進行中の地政学イベント（首脳会談・紛争・制裁・封鎖シナリオ等）を最新順で返す。`topic`: us-china / middle-east / ukraine / japan / global。記事メタデータ（タイトル・配信元・配信日時・URL）のみで、解釈は呼び出し側 LLM の責務 |
|
|
32
|
-
| `get_quote` | 任意の Yahoo Finance ティッカー（株・為替・指数・コモディティ・暗号資産）の現在値・前日比を取得。例: `AAPL` / `^DJI` / `BTC-USD`。`includeFundamentals: true` で PER / PBR / 配当利回り / ベータ / 時価総額も取得（v0.6.0） |
|
|
39
|
+
| `get_quote` | 任意の Yahoo Finance ティッカー（株・為替・指数・コモディティ・暗号資産）の現在値・前日比を取得。例: `AAPL` / `^DJI` / `BTC-USD`。`includeFundamentals: true` で PER / PBR / 配当利回り / ベータ / 時価総額も併せて取得 |
|
|
33
40
|
|
|
34
|
-
###
|
|
41
|
+
### 市況俯瞰 — 5 ツール
|
|
35
42
|
|
|
36
43
|
| ツール名 | 説明 |
|
|
37
44
|
|---|---|
|
|
38
45
|
| `get_market_thermometer` | VIX・S&P 500・米10年金利・ドル指数を合成した 0-100 のリスクオン/オフ・スコア + 過去 30 営業日推移 |
|
|
39
46
|
| `get_performance_ranking` | 28 銘柄を `1d`/`1w`/`1m` のパフォーマンスでソート、上位/下位 N 件を返す |
|
|
40
47
|
| `get_yield_spread` | 米10年-5年イールドスプレッド（プラス=順イールド / マイナス=逆イールド） |
|
|
41
|
-
| `get_market_sessions` | 主要 4 市場（東京・上海・ロンドン・NY）の現在の取引時間ステータス（open / pre-open / closed /
|
|
48
|
+
| `get_market_sessions` | 主要 4 市場（東京・上海・ロンドン・NY）の現在の取引時間ステータス（open / pre-open / closed / holiday、祝日対応） |
|
|
42
49
|
| `get_sector_heatmap` | 米株セクター ETF（SPDR、11 セクター）の前日比一覧 |
|
|
43
50
|
|
|
44
|
-
###
|
|
51
|
+
### 個別株の深掘り — 2 ツール
|
|
45
52
|
|
|
46
53
|
| ツール名 | 説明 |
|
|
47
54
|
|---|---|
|
|
48
55
|
| `get_dividend_history` | 個別株・ETF の過去 N 年の配当履歴と暦年合計を取得（`years`: 1/3/5/10、既定 5）。NISA 成長投資枠で配当銘柄を検討する一次情報として使用 |
|
|
49
56
|
| `get_analyst_consensus` | 個別株のアナリスト推奨レーティング（強気買い〜強気売り）・目標株価（平均/高値/安値）・月別推奨内訳を取得。米国株は coverage が厚く、TSE 銘柄や ETF は欠損しやすい |
|
|
50
57
|
|
|
51
|
-
###
|
|
58
|
+
### 経済イベント & マクロ最新値 — 3 ツール
|
|
59
|
+
|
|
60
|
+
「**次にいつ発表されるか**」（カレンダー系 2 つ）と「**今の数字はいくつか**」（最新値 1 つ）を分担。
|
|
61
|
+
|
|
62
|
+
| ツール名 | 説明 |
|
|
63
|
+
|---|---|
|
|
64
|
+
| `get_economic_events_today` | 当日 or 今週の経済イベント（FOMC・日銀金融政策決定会合・米雇用統計・CPI・GDP・中国 PMI 等）を重要度付きで返す。`category` で `macro` / `policy` に絞り込み可能。期間イベント（ジャクソンホール会議等）は `endDate` で複数日対応。半年分を手動キュレーション |
|
|
65
|
+
| `get_economic_release_pulse` | **6 公式機関の発表予定を実取得**: BEA / NY 連銀 / FRB / **BLS（PFEI 経由）** / 内閣府 / 日銀 のカレンダーを並列取得し、本日・今週・今月の経済指標リリース予定を統合して返す。BLS 三大指標の発表予定は v0.14.0 でホワイトハウス OMB/OIRA の PFEI Schedule 統合により対応 |
|
|
66
|
+
| `get_us_macro_latest` | **米マクロ 7 系列の最新発表値**: 雇用統計・失業率・CPI・コア CPI・PPI・コア PPI・平均時給 を BLS Public Data API v2 から 1 リクエストで取得。値 + 前月比 + 前年同月比を返す。API key 不要・無認証 1 日 25 リクエスト・6 時間キャッシュ |
|
|
67
|
+
|
|
68
|
+
### 地政学 — 2 ツール
|
|
69
|
+
|
|
70
|
+
確定スケジュール（カレンダー）とリアルタイム速報（パルス）の 2 系統。
|
|
52
71
|
|
|
53
72
|
| ツール名 | 説明 |
|
|
54
73
|
|---|---|
|
|
55
|
-
| `
|
|
74
|
+
| `get_geopolitical_calendar` | **確定済み公式スケジュール**: 本日・今週・今月の地政学イベントを 4 サブカテゴリ（summit / bilateral / election / risk）で返す。`marketImplications` / `participants` / `sourceUrl` 付き。半年に 1 回 PR で手動更新の静的データ |
|
|
75
|
+
| `get_geopolitical_pulse` | **リアルタイム速報**: BBC World・Al Jazeera・Google News（トピック検索）の RSS を並列取得し、進行中の地政学イベント（首脳会談・紛争・制裁・封鎖シナリオ等）を最新順で返す。`topic`: us-china / middle-east / ukraine / japan / global。記事メタデータ（タイトル・配信元・配信日時・URL）のみで、解釈は呼び出し側 LLM の責務 |
|
|
76
|
+
|
|
77
|
+
## HTTP 通信について
|
|
78
|
+
|
|
79
|
+
市況・分析・個別株系ツールは **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** へ HTTPS リクエストを送信します。実行 PC のネットワークから外部に出る通信が発生する点にご留意ください。
|
|
56
80
|
|
|
57
|
-
|
|
58
|
-
>
|
|
59
|
-
> v0.6.0 で `get_quote includeFundamentals=true` / `get_dividend_history` / `get_analyst_consensus` の 3 ルートが Yahoo Finance v10 quoteSummary（crumb 認証あり）を経由するため、`yahoo-finance2` パッケージを依存に追加しました。
|
|
81
|
+
データは数十分〜1 時間遅れの参考値で、**投資助言ではなく情報集約**として提供しています。
|
|
60
82
|
|
|
61
|
-
|
|
83
|
+
> `get_quote` の fundamentals / `get_dividend_history` / `get_analyst_consensus` は Yahoo Finance v10 quoteSummary（crumb 認証あり）を経由するため、依存パッケージとして `yahoo-finance2` を利用します。
|
|
62
84
|
|
|
63
85
|
## インストール / 設定
|
|
64
86
|
|
|
@@ -119,7 +141,7 @@ echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":
|
|
|
119
141
|
{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | node dist/index.js
|
|
120
142
|
```
|
|
121
143
|
|
|
122
|
-
`tools/list` のレスポンスに
|
|
144
|
+
`tools/list` のレスポンスに 18 ツールが並べば成功です。
|
|
123
145
|
|
|
124
146
|
## 使用例
|
|
125
147
|
|
|
@@ -131,21 +153,25 @@ Claude にこんな依頼ができます:
|
|
|
131
153
|
- 「100万円を年利5%で30年複利運用したらいくらになる？」
|
|
132
154
|
- 「月3万円を年利6%で20年積み立てたら？」
|
|
133
155
|
|
|
134
|
-
|
|
156
|
+
**市況スナップショット**
|
|
135
157
|
- 「今日の市況を要約して」「主要指標の前日比を表で見せて」
|
|
136
|
-
- 「今週の経済イベントは？特に FOMC や日銀の予定を教えて」
|
|
137
158
|
- 「米10年金利と日経平均の動きから、今のリスクオン度合いをコメントして」
|
|
138
159
|
- 「BTC-USD の今の値は？」「ポンド円（GBPJPY=X）を教えて」
|
|
139
160
|
|
|
140
|
-
|
|
161
|
+
**個別株の深掘り**
|
|
141
162
|
- 「KO の過去 10 年の配当推移を見せて」「VYM の年次配当合計は？」
|
|
142
163
|
- 「NVDA のアナリスト目標株価と推奨レーティングは？」
|
|
143
164
|
- 「AAPL の PER / PBR / 配当利回り / ベータをまとめて」（`get_quote` で `includeFundamentals=true`）
|
|
144
165
|
|
|
145
|
-
|
|
166
|
+
**経済指標カレンダー & 最新値**
|
|
167
|
+
- 「今週の経済イベントは？特に FOMC や日銀の予定を教えて」
|
|
168
|
+
- 「**次の雇用統計はいつ？**」「**今月の FRB と内閣府の発表予定をまとめて**」
|
|
169
|
+
- 「**直近の CPI と PPI を前月比・前年同月比で**」「**コア CPI とコア PPI を比較して**」
|
|
170
|
+
|
|
171
|
+
**地政学イベント**
|
|
146
172
|
- 「今週の地政学イベントは？」「今月の G7 サミットの予定は？」
|
|
147
|
-
-
|
|
148
|
-
-
|
|
173
|
+
- 「次の米中首脳会談はいつ？」「日本に関係する首脳会談だけ抽出して」（`country=["JP"]` で絞り込み）
|
|
174
|
+
- 「**今のイラン情勢のヘッドラインは？**」「**ウクライナ和平の最新ニュースは？**」
|
|
149
175
|
|
|
150
176
|
## 投資判断の免責
|
|
151
177
|
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "lit-forge-mcp",
|
|
3
|
-
"version": "0.14.
|
|
3
|
+
"version": "0.14.1",
|
|
4
4
|
"mcpName": "io.github.noblabs/lit-forge-mcp",
|
|
5
|
-
"description": "MCP server
|
|
5
|
+
"description": "MCP server (18 tools): NISA/iDeCo/retirement simulation, 28-indicator market snapshot, economic release calendars (BEA/NY Fed/FRB/BLS/Cabinet Office/BOJ), latest BLS macro values (7 series), and geopolitical calendar + pulse.",
|
|
6
6
|
"type": "module",
|
|
7
7
|
"license": "MIT",
|
|
8
8
|
"homepage": "https://github.com/noblabs/lit-forge-mcp",
|
|
@@ -29,6 +29,9 @@
|
|
|
29
29
|
"economic-calendar",
|
|
30
30
|
"dividend",
|
|
31
31
|
"analyst",
|
|
32
|
+
"geopolitical",
|
|
33
|
+
"bls",
|
|
34
|
+
"macro",
|
|
32
35
|
"japan"
|
|
33
36
|
],
|
|
34
37
|
"bin": {
|