bluelamp 6.4.8 → 6.4.10

package/README.md

@@ -25,7 +25,59 @@ bluelamp42    # slot #42
 - `bin/bluelamp1.mjs` 〜 `bin/bluelamp200.mjs` — `bluelamp-vscode-base.mjs` を import する薄いトランポリン
 - `scripts/build-obfuscate.mjs` — 2 段階難読化 (Terser + javascript-obfuscator HIGH) の production build
 - `scripts/generate-commands.ts` — 200 トランポリンの冪等再生成 (`dist/scripts/generate-commands.js` にコンパイル)
-- `scripts/setup-mcps.ts` — `~/.bluelamp/` / `~/.mcp.json` セットアップ (グローバルインストール時に手動実行)
+
+## MCP 配布の仕組み（重要）
+
+受講生 PC の Claude Code に MCP を「配る」のは、**`npm install -g bluelamp` で入るこのパッケージの launcher が、起動のたびに `--mcp-config` を生成して `claude` に渡している**から。ユーザーは MCP 設定ファイルを一切編集しない。
+
+```
+bluelampN (trampoline)
+  → bin/bluelamp-vscode-base.mjs
+      → createMCPConfig()  : os.tmpdir() に bluelamp-mcp-<ts>.json を書く
+      → spawn('claude', [..., '--mcp-config', <temp>])
+```
+
+`createMCPConfig()`（`bin/bluelamp-vscode-base.mjs`）が書く中身は現状 MCP **1 個だけ**:
+
+```jsonc
+{
+  "mcpServers": {
+    "bluelamp": {                          // gateway。これ 1 個が全 cloud_proxy tool を露出
+      "command": "node",
+      "args": ["<pkg>/lib/mcp-server/index.cjs"],
+      "env": {
+        "MUSUHI_TOKEN":     cliToken,       // ~/.musuhi/portal-token.enc 由来（TokenManager）
+        "MUSUHI_KEYWORD":   keyword,        // slot → エージェント
+        "MUSUHI_TENANT_ID": "...",          // アクティブテナント
+        "PORTAL_URL":       "..."
+      }
+    }
+  }
+}
+```
+
+- `load_knowledge` / `install_from_store` / `tenant-agents` 等の "BlueLamp MCP" は **全部この `bluelamp` gateway 1 プロセス経由**。tool を増やしても MCP プロセスは増えない。
+- token は **launcher 起動時に env 固定注入**。→ ログアウト / アカウント切替の効果は **次回 `bluelampN` 起動から**（in-session では差し替わらない）。
+
+### ローカル MCP を 1 個足したいとき（例: アカウント管理 MCP）
+
+cloud_proxy（portal 転送）では触れない **ローカル操作**（token 削除・`npm install -g bluelamp@latest`）をする MCP は、`@bluelamp/mcp-shim`（転送専用）では作れない。代わりに:
+
+1. `packages/bluelamp-cli/lib/` にローカル MCP スクリプトを bundle する（`lib/` は build で `dist/lib/` にコピーされ npm 同梱される）
+2. `createMCPConfig()` の `mcpServers` に **2 個目**を足す（ローカル操作のみなら env 注入は不要。token は MCP 側が `~/.musuhi/portal-token.enc` を直読み）
+3. `bluelamp` を再 publish → 受講生は自己更新で入手 → launcher が毎回 temp config に書く＝**自動配布・自動登録**
+
+別 npm パッケージも、ユーザーの設定編集も不要。これが「`npm install -g bluelamp` だけで MCP が増える」の実体。
+
+> **実装済み（Phase 151）**: 第1号が `lib/account-mcp/index.cjs`（MCP 名 `bluelamp-account`）。tool = `logout`（`~/.musuhi/portal-token.enc` を削除＝別アカウント切替の起点）/ `update_cli`（`npm i -g bluelamp@latest`）。`createMCPConfig()` に登録済み。効果はどちらも **次回 `bluelampN` 起動から**（起動中の gateway は起動時 token を保持するため in-session では切り替わらない）。
+
+### `@bluelamp/mcp-shim` との違い
+
+| | gateway / ローカル MCP（このパッケージの `lib/`） | `@bluelamp/mcp-shim`（別 npm） |
+|---|---|---|
+| 配布 | `bluelamp` 本体に同梱、launcher が `--mcp-config` で登録 | `manifest.json` だけで動く cloud_proxy 用 shim |
+| できること | **ローカル操作**（token / fs / npm）も可 | portal `/api/cli/mcp-dispatch` への **転送のみ** |
+| 用途 | gateway 本体、アカウント管理 など | cloud_proxy + externalApi の汎用 tool |
 
 ## 開発