bluelamp weekly downloads statistics

bluelamp

BlueLamp CLI — Claude Code 用 MCP セットアップ + 200 個の bluelamp1 〜 bluelamp200 コマンドを提供する npm パッケージ。

インストール (受講生向け)

npm install -g bluelamp

インストール後、 bluelamp1 〜 bluelamp200 のいずれかを実行すると Claude Code が起動し、 対応する slot の MCP 設定がロードされます。

bluelamp1     # slot #1
bluelamp42    # slot #42
# ...

配布物が難読化されていることについて

npm で配布している bluelamp の dist/ は、意図的に難読化してあります。中身がそのまま読めないのはビルドの設計であって、隠しごとではありません。以下にその理由を記します。

なぜ難読化しているのか

• 認証とトークンの取り扱いを守るため。 この CLI は利用者の資格情報とアクセストークンを端末上で扱います。その取り回しを読める形のまま配ると、なりすましやトークンの窃取を試みる側に手順を渡すことになります。
• 当社の知的資産を守るため。 BlueLamp の価値は積み上げてきた設計そのものにあり、配布物はその一部を含みます。

難読化が掛かるのは配布物 (dist/) だけです。ソースは非公開です。 配布物への署名 (正規ビルドであることを第三者の立場で確かめる仕組み) は準備中です (下の「正規のビルドであることの確かめ方」)。ビルドの段取りそのものは下の「ビルド出力」の節のとおりです。

利用者にとって何が変わらないのか

• 機能・挙動は変わりません。 難読化は publish 用ビルドの最終工程で、実行される処理は tsc が出したものと同じです。
• 通信先は増えません。 CLI が接続するのは当社ポータルの API と、起動する Claude Code だけです。送信先はコードに固定されており、設定で任意の URL に向け替えることはできません。
• 第三者の解析サービスへの送信はありません。 テレメトリ / 解析 SDK を同梱していません。当社ポータルとの通信は認証と機能提供のためのものです。
• 認証トークンは利用者の端末内 (~/.musuhi/portal-token.enc) にのみ保存されます。

正規のビルドであることの確かめ方

準備中です。 公開している tarball への署名 (公開の透明性ログへの記録) は、まだ行っていません。そのため、現時点ではどの版も透明性ログを引いても記録は返りません。これは改ざんを意味するものではありません。

ウイルス対策ソフトが反応した場合

難読化されたコードは、その形からヒューリスティックに検知されることがあります (誤検知)。お使いのウイルス対策製品が bluelamp を検知した場合は、下記の窓口から誤検知として報告できます。

• 各ウイルス対策ベンダーの窓口一覧: https://docs.virustotal.com/docs/false-positive-contacts VirusTotal 自身は判定を出さず、誤検知は各エンジンのベンダーへ直接報告する形になっています。上記ページに 150 社以上の窓口がまとまっているので、検知した製品の窓口から報告してください。
• Microsoft Defender (Windows): https://www.microsoft.com/en-us/wdsi/filesubmission サインイン不要でファイルを送信でき、誤検知として申告できます。

構成

• src/auth/ — Portal API auth client + token manager + interactive login
• src/utils/ — 共通 logger
• src/i18n/ — t(key, params) / setLanguage(lang) (ja / en)
• bin/bluelamp-vscode-base.mjs — Claude Code 起動 + MCP 設定生成の本体 (ESM)
• 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 にコンパイル)

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 個だけ:

{
  "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-admin 等の "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() に登録済み。 update_cli の効果は 次回 bluelampN 起動から（実行中のプロセスは差し替わらない）。logout／トークン差し替えが効くタイミングは版で異なる——6.6.0 までは次回起動から、板#341 N1 以降は gateway がトークンを毎回読み直すため次の tool 呼び出しから。 📌 利用者向けの手順・失効時の復旧・罹患判定は docs/support-knowledge/account-operations.md が正本（ここには書き写さない）。

@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

開発

pnpm install                                                # workspace root で 1 回
pnpm --filter bluelamp run build:tsc                    # tsc emit のみ
pnpm --filter bluelamp run build                        # tsc emit → 難読化 (publish 用)
pnpm --filter bluelamp run tsc                          # 型チェックのみ
pnpm --filter bluelamp run test                         # node --test (auth + bin)
pnpm --filter bluelamp run generate:bins                # bin/bluelamp1-200.mjs 再生成

ビルド出力

pnpm run build は 2 段階で dist/ を生成する:

1. tsc emit — src/ の TypeScript を dist/auth/, dist/i18n/, dist/utils/, dist/scripts/, dist/index.js に出力
2. build-obfuscate — bin/*.mjs を dist/bin/ にコピー (import path を dist/bin/ 起点に補正)、 dist/ 配下を 2 段階で難読化
   • HIGH (javascript-obfuscator) — dist/auth/*.js + dist/scripts/setup-mcps.js + dist/bin/bluelamp-vscode-base.mjs (5 file)
   • Terser (軽量縮小) — それ以外の dist/*.js + dist/bin/bluelamp{1-200}.mjs

publish 対象は dist/ + README.md のみ (package.json files で制限)。

移行元との対応…