bluelamp 6.3.3 → 6.3.5

package/lib/mcp-server/index.cjs

@@ -1,2 +1,1129 @@
 #!/usr/bin/env node
-const{Server:Server}=require("@modelcontextprotocol/sdk/server/index.js"),{StdioServerTransport:StdioServerTransport}=require("@modelcontextprotocol/sdk/server/stdio.js"),{CallToolRequestSchema:CallToolRequestSchema,ListToolsRequestSchema:ListToolsRequestSchema}=require("@modelcontextprotocol/sdk/types.js"),{getPromptFromPortal:getPromptFromPortal,listAvailableMcps:listAvailableMcps,downloadMcpPackage:downloadMcpPackage,getGatewayConfig:getGatewayConfig,searchMcpServices:searchMcpServices,installMcpService:installMcpService,setServiceAlwaysOn:setServiceAlwaysOn,uninstallMcpService:uninstallMcpService,updateMcpEnv:updateMcpEnv,callMcpToolProxy:callMcpToolProxy}=require("./portal-api-client.cjs"),{logger:logger}=require("../utils/logger"),{t:t,setLanguage:setLanguage}=require("../i18n"),{spawn:spawn}=require("child_process"),path=require("path"),fs=require("fs"),os=require("os"),dotenvLocalPath=path.join(__dirname,"../../.env.local"),dotenvPath=path.join(__dirname,"../../.env");fs.existsSync(dotenvLocalPath)?(require("dotenv").config({path:dotenvLocalPath}),logger.debug("[MCP Server] Loaded .env.local")):fs.existsSync(dotenvPath)&&(require("dotenv").config({path:dotenvPath}),logger.debug("[MCP Server] Loaded .env"));const KEYWORD=process.env.MUSUHI_KEYWORD||"BL-要件定義",TOKEN=process.env.MUSUHI_TOKEN,isDevEnv="development"===process.env.NODE_ENV||process.env.PORTAL_URL&&process.env.PORTAL_URL.includes("localhost"),PORTAL_URL=process.env.PORTAL_URL||(isDevEnv?"http://localhost:8432":"https://motohi-api-235426778039.asia-northeast1.run.app"),LANGUAGE=process.env.MUSUHI_LANGUAGE||"ja";setLanguage(LANGUAGE);const LOG_DIR=path.join(os.homedir(),".bluelamp-vscode","logs"),LOG_FILE=path.join(LOG_DIR,"mcp.log");function log(e){const t=`[${(new Date).toISOString()}] ${e}\n`;fs.appendFileSync(LOG_FILE,t),logger.info(`[MCP Server] ${e}`)}fs.existsSync(LOG_DIR)||fs.mkdirSync(LOG_DIR,{recursive:!0}),log(`MCP Server started - Log file: ${LOG_FILE}`),log("Environment variables:"),log(`  KEYWORD: ${KEYWORD}`),log("  TOKEN: "+(TOKEN?TOKEN.substring(0,20)+"...":"NOT SET")),log(`  PORTAL_URL: ${PORTAL_URL}`),log(`  LANGUAGE: ${LANGUAGE}`);const LEGACY_REGISTRY=path.join(os.homedir(),".bluelamp","registry.json");if(fs.existsSync(LEGACY_REGISTRY))try{fs.unlinkSync(LEGACY_REGISTRY),log(`[startup] Legacy registry.json removed: ${LEGACY_REGISTRY}`)}catch(e){log(`[startup] Failed to remove legacy registry.json: ${e.message}`)}class ChildMcpProcess{constructor(e,t,r,o){this.serviceId=e,this.command=t,this.args=(r||[]).map(e=>"string"==typeof e?e.replace(/^~\//,os.homedir()+"/"):e),this.env={...process.env,...o},this.process=null,this.tools=[],this.requestId=0,this.pending=new Map,this.buffer=""}async start(){return new Promise((e,t)=>{const r=setTimeout(()=>{t(new Error(`Timeout: "${this.serviceId}" failed to start within 30s`)),this.stop()},3e4);try{this.process=spawn(this.command,this.args,{env:this.env,stdio:["pipe","pipe","pipe"]}),this.process.on("error",e=>{clearTimeout(r),t(new Error(`Spawn error for "${this.serviceId}": ${e.message}`))}),this.process.on("exit",(e,t)=>{log(`[ChildMcp] "${this.serviceId}" exited (code=${e}, signal=${t})`),this.pending.forEach(e=>e.reject(new Error("Process exited"))),this.pending.clear()}),this.process.stderr.on("data",e=>{log(`[ChildMcp:${this.serviceId}:stderr] ${e.toString().trim()}`)}),this.process.stdout.on("data",e=>{this.buffer+=e.toString(),this._processBuffer()}),this._sendRequest("initialize",{protocolVersion:"2024-11-05",capabilities:{},clientInfo:{name:"bluelamp-gateway",version:"1.0.0"}}).then(e=>(log(`[ChildMcp] "${this.serviceId}" initialized: ${JSON.stringify(e.serverInfo||{})}`),this._sendNotification("notifications/initialized",{}),this._sendRequest("tools/list",{}))).then(t=>{const o=t.tools||[];this.tools=o.map(e=>({...e,name:`${this.serviceId}__${e.name}`,_originalName:e.name})),log(`[ChildMcp] "${this.serviceId}" ready: ${this.tools.length} tools`),clearTimeout(r),e(this.tools)}).catch(e=>{clearTimeout(r),t(e)})}catch(e){clearTimeout(r),t(e)}})}async callTool(e,t){return await this._sendRequest("tools/call",{name:e,arguments:t})}stop(){this.process&&(this.process.kill(),this.process=null),this.pending.forEach(e=>e.reject(new Error("Process stopped"))),this.pending.clear()}_sendRequest(e,t){return new Promise((r,o)=>{const s=++this.requestId,i=JSON.stringify({jsonrpc:"2.0",id:s,method:e,params:t})+"\n";this.pending.set(s,{resolve:r,reject:o});try{this.process.stdin.write(i)}catch(e){this.pending.delete(s),o(new Error(`Write error: ${e.message}`))}})}_sendNotification(e,t){const r=JSON.stringify({jsonrpc:"2.0",method:e,params:t})+"\n";try{this.process.stdin.write(r)}catch(e){log(`[ChildMcp] Notification write error: ${e.message}`)}}_processBuffer(){const e=this.buffer.split("\n");this.buffer=e.pop();for(const t of e){const e=t.trim();if(e)try{const t=JSON.parse(e);if(t.id&&this.pending.has(t.id)){const e=this.pending.get(t.id);this.pending.delete(t.id),t.error?e.reject(new Error(`JSON-RPC error: ${JSON.stringify(t.error)}`)):e.resolve(t.result)}}catch(t){log(`[ChildMcp:${this.serviceId}] Parse error: ${t.message} | line: ${e.substring(0,200)}`)}}}}class ChildMcpManager{constructor(){this.children=new Map}async activateExternal(e,t){const r=new ChildMcpProcess(e,t.command,t.args||[],t.env||{}),o=await r.start();return this.children.set(e,{type:"external",process:r,tools:o,service:t}),o}deactivate(e){const t=this.children.get(e);t&&("external"===t.type&&t.process&&t.process.stop(),this.children.delete(e))}isActive(e){return this.children.has(e)}getActiveTools(){const e=[];for(const t of this.children.values())e.push(...t.tools||[]);return e}async callTool(e,t){for(const[r,o]of this.children)if("external"===o.type){const r=o.tools.find(t=>t.name===e);if(r)return{found:!0,result:await o.process.callTool(r._originalName,t)}}return{found:!1}}getActiveServiceIds(){return[...this.children.keys()]}}class BlueLampServer{constructor(){this.childManager=new ChildMcpManager,this.server=new Server({name:"bluelamp",version:"2.0.0"},{capabilities:{tools:{listChanged:!0}}}),this.setupHandlers()}checkAuth(){return TOKEN?{ok:!0}:{ok:!1,error:"MUSUHI_TOKEN が設定されていません。BlueLampにログインしてください。"}}buildToolList(){const e=[{name:"load_knowledge",description:t("mcp.toolDescriptionLoadKnowledge"),annotations:{readOnlyHint:!0,idempotentHint:!0},inputSchema:{type:"object",properties:{keyword:{type:"string",description:t("mcp.keywordDescription")}},required:["keyword"]}},{name:"search_mcp",description:'キーワードでインストール済みMCPサービスを検索します。使いたい機能を自然言語で説明してください。（例: "ブラウザ操作", "メール送信", "画像生成"）',inputSchema:{type:"object",properties:{query:{type:"string",description:"検索キーワード（自然言語OK）"}},required:["query"]}},{name:"activate_service",description:"MCPサービスを有効化してツールを追加します。search_mcpで見つけたservice_idを指定してください。always_on: trueで次回以降も自動的に有効化されます。",inputSchema:{type:"object",properties:{service_id:{type:"string",description:"サービスID"},always_on:{type:"boolean",description:"trueにすると常時アクティブ（毎回自動起動）になります"}},required:["service_id"]}},{name:"deactivate_service",description:"MCPサービスの常時アクティブ（alwaysOn）設定を解除します。次回起動時から自動有効化されなくなります。",inputSchema:{type:"object",properties:{service_id:{type:"string",description:"サービスID"}},required:["service_id"]}},{name:"restart_service",description:"MCPサービスのプロセスを再起動します。コード更新や設定変更の反映に使用します。",inputSchema:{type:"object",properties:{service_id:{type:"string",description:"サービスID"}},required:["service_id"]}},{name:"unregister_service",description:"MCPサービスをレジストリから完全に削除します。プロセスも停止します。",inputSchema:{type:"object",properties:{service_id:{type:"string",description:"削除するサービスID"}},required:["service_id"]}},{name:"register_service",description:"新しいMCPサービスをゲートウェイに登録します。",inputSchema:{type:"object",properties:{service_id:{type:"string",description:'サービスID（英数字、例: "microcms"）'},name:{type:"string",description:"サービス表示名"},description:{type:"string",description:"サービスの説明"},tags:{type:"array",items:{type:"string"},description:"検索用タグ"},command:{type:"string",description:'実行コマンド（"npx" or "node"）'},args:{type:"array",items:{type:"string"},description:"コマンド引数"},env:{type:"object",description:"環境変数"}},required:["service_id","name","description","tags"]}},{name:"browse_mcp_store",description:"MCPストア（Portal）からインストール可能なMCP一覧を取得します。",inputSchema:{type:"object",properties:{category:{type:"string",description:"カテゴリでフィルタ（省略可）"}},required:[]}},{name:"install_from_store",description:"MCPストアからMCPをダウンロードしてインストールします。browse_mcp_storeで見つけたmcp_idを指定してください。",inputSchema:{type:"object",properties:{mcp_id:{type:"string",description:"インストールするMCPのID"}},required:["mcp_id"]}},{name:"save_mcp_env",description:"MCPの環境変数（APIキー等）をサーバーに安全に保存します。ローカルには保存されません。次回起動時にサーバーから自動取得されます。解約時はアクセスできなくなります。",inputSchema:{type:"object",properties:{service_id:{type:"string",description:"MCP サービスID（例: heygen, gemini-image）"},env:{type:"object",description:'環境変数のキーと値（例: {"HEYGEN_API_KEY": "sk_xxx"}）',additionalProperties:{type:"string"}}},required:["service_id","env"]}}];if(e.push(...this.childManager.getActiveTools()),this._cloudProxyTools)for(const[t,r]of this._cloudProxyTools)e.push({name:t,description:r.description||`[${r.mcpId}] ${r.toolName}`,inputSchema:r.inputSchema||{type:"object",properties:{}}});return e}setupHandlers(){this.server.setRequestHandler(ListToolsRequestSchema,async()=>{const e=this.buildToolList(),t=this.childManager.getActiveServiceIds();return log(`[ListTools] ${e.length} tools (active: ${t.join(", ")||"none"})`),{tools:e}}),this.server.setRequestHandler(CallToolRequestSchema,async e=>{const{name:r,arguments:o}=e.params;if(log(`[CallTool] ${r}`),"load_knowledge"===r){const{keyword:e}=o;log(`[load_knowledge] keyword: ${e}`);try{const r=await getPromptFromPortal(e,TOKEN,LANGUAGE);if(!r||!r.success){const o=r?.error||t("mcp.knowledgeNotFound",{keyword:e});return{content:[{type:"text",text:`❌ ${t("mcp.portalApiFailed",{error:o})}`}],isError:!0}}const o="ja"!==LANGUAGE?"\n\n[Note] The user's preferred language is English.":"";return{content:[{type:"text",text:`✅ ${t("mcp.knowledgeLoadSuccess")}\n\n${r.knowledge}${o}\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n${t("mcp.knowledgeApplied")}`}]}}catch(e){return log(`[load_knowledge] Exception: ${e.message}`),{content:[{type:"text",text:`❌ ${t("mcp.knowledgeLoadError",{error:e.message})}`}],isError:!0}}}if("search_mcp"===r){const e=this.checkAuth();if(!e.ok)return{content:[{type:"text",text:`🔒 ${e.error}`}],isError:!0};if(!TOKEN)return{content:[{type:"text",text:"❌ 未認証です。MCPカタログの検索にはログインが必要です。"}],isError:!0};let t=[];try{const e=await searchMcpServices(o.query,TOKEN);if(!e.success)return{content:[{type:"text",text:`❌ MCPカタログ検索に失敗: ${e.error||"Unknown"}`}],isError:!0};t=(e.data||[]).map(e=>({id:e.mcp_id,service:{name:e.name,description:e.description,tags:[],alwaysOn:e.alwaysOn||!1},isInstalled:e.isInstalled||!1}))}catch(e){return log(`[search_mcp] Server search failed: ${e.message}`),{content:[{type:"text",text:`❌ MCPカタログ検索に失敗: ${e.message}`}],isError:!0}}if(0===t.length)return{content:[{type:"text",text:`🔍 「${o.query}」に一致するサービスはありません。\n\n別のキーワードで試すか、browse_mcp_storeでカタログを確認してください。`}]};let r=`🔍 「${o.query}」の検索結果（${t.length}件）\n\n`;for(const e of t.slice(0,10)){const t=e.id,o=e.service,s=this.childManager.isActive(t),i=o.alwaysOn,n=e.isInstalled?"":" [未インストール]",c=i?" [常時アクティブ]":"";r+=`${i?"🔒":s?"🟢":"⚪"} **${o.name}**${c}${n} (id: \`${t}\`)\n`,r+=`   ${o.description}\n\n`}return r+="有効化: activate_service | インストール: install_from_store",{content:[{type:"text",text:r}]}}if("activate_service"===r){const e=this.checkAuth();if(!e.ok)return{content:[{type:"text",text:`🔒 ${e.error}`}],isError:!0};const{service_id:t,always_on:r}=o,s=await getGatewayConfig(TOKEN);if(!s.success)return{content:[{type:"text",text:`❌ サーバー設定の取得に失敗: ${s.error||"Unknown"}`}],isError:!0};const i=(s.data?.services||[]).find(e=>e.mcpId===t);if(!i)return{content:[{type:"text",text:`❌ サービス "${t}" はインストールされていません。install_from_storeでインストールしてください。`}],isError:!0};if(r&&(setServiceAlwaysOn(t,!0,TOKEN).catch(e=>log(`[activate] Server sync failed: ${e.message}`)),log(`[activate] "${t}" set alwaysOn: true`)),this.childManager.isActive(t))return{content:[{type:"text",text:`ℹ️ "${t}" は既に有効です。${r?"（常時アクティブに設定しました）":""}`}]};if("cloud_proxy"===i.hostingType){const e=Array.isArray(i.tools)?i.tools:[];if(0===e.length)return{content:[{type:"text",text:`❌ "${t}" (cloud_proxy) にツール定義がありません。`}],isError:!0};this._cloudProxyTools=this._cloudProxyTools||new Map;for(const r of e){const e=`${t}__${r.name}`;this._cloudProxyTools.set(e,{mcpId:t,toolName:r.name,description:r.description,inputSchema:r.inputSchema})}log(`[activate] "${t}" (cloud_proxy) → ${e.length} proxy tools registered`);try{await this.server.notification({method:"notifications/tools/list_changed"})}catch(e){log(`[activate] notification error: ${e.message}`)}const o=e.map(e=>`${t}__${e.name}`).join(", "),s=r?" 🔒常時アクティブ":"";return{content:[{type:"text",text:`✅ "${i.name}" を有効化しました${s}（cloud_proxy ツール${e.length}個追加）\n\n追加ツール: ${o}`}]}}const n=path.join(os.homedir(),".claude","mcp-servers",t),c=i.entryPoint||"dist/index.js",a={name:i.name,description:i.description,type:"external",command:i.command||"node",args:i.args&&i.args.length?i.args:[path.join(n,c)],env:i.env||{}};let l;try{l=await this.childManager.activateExternal(t,a)}catch(e){return log(`[activate] Failed "${t}": ${e.message}`),{content:[{type:"text",text:`❌ "${t}" の起動に失敗しました: ${e.message}`}],isError:!0}}const p=l.map(e=>e.name).join(", "),d=r?" 🔒常時アクティブ":"";log(`[activate] "${t}" → ${l.length} tools${r?" (alwaysOn)":""}. Sending list_changed.`);try{await this.server.notification({method:"notifications/tools/list_changed"})}catch(e){log(`[activate] notification error: ${e.message}`)}return{content:[{type:"text",text:`✅ "${a.name}" を有効化しました${d}（ツール${l.length}個追加）\n\n追加ツール: ${p||"(なし)"}`}]}}if("deactivate_service"===r){const{service_id:e}=o;if(!TOKEN)return{content:[{type:"text",text:"🔒 未認証です。ログインが必要です。"}],isError:!0};const t=await setServiceAlwaysOn(e,!1,TOKEN);if(!t.success)return{content:[{type:"text",text:`❌ "${e}" の解除に失敗: ${t.error||"Unknown"}`}],isError:!0};log(`[deactivate] "${e}" set alwaysOn: false`);let r=0;if(this._cloudProxyTools){const t=`${e}__`;for(const e of[...this._cloudProxyTools.keys()])e.startsWith(t)&&(this._cloudProxyTools.delete(e),r++);r>0&&log(`[deactivate] "${e}" (cloud_proxy) → ${r} proxy tools removed`)}let s=!1;if(this.childManager.isActive(e)&&(this.childManager.deactivate(e),log(`[deactivate] "${e}" child process stopped`),s=!0),r>0||s)try{await this.server.notification({method:"notifications/tools/list_changed"})}catch(e){log(`[deactivate] notification error: ${e.message}`)}let i=`✅ "${e}" の常時アクティブを解除しました。`;return r>0&&(i+=` cloud_proxy ツール${r}個を削除しました。`),s&&(i+=" 子プロセスを停止しました。"),i+=" 次回起動時から自動有効化されません。",{content:[{type:"text",text:i}]}}if("restart_service"===r){const{service_id:e}=o,t=this.childManager.children.get(e),r=t?.service;if(!r)return{content:[{type:"text",text:`❌ "${e}" は現在アクティブではありません。activate_service で有効化してください。`}],isError:!0};let s;this.childManager.deactivate(e),log(`[restart] "${e}" stopped`);try{s=await this.childManager.activateExternal(e,r)}catch(t){return log(`[restart] Failed "${e}": ${t.message}`),{content:[{type:"text",text:`❌ "${e}" の再起動に失敗しました: ${t.message}`}],isError:!0}}log(`[restart] "${e}" → ${s.length} tools. Sending list_changed.`);try{await this.server.notification({method:"notifications/tools/list_changed"})}catch(e){log(`[restart] notification error: ${e.message}`)}const i=s.map(e=>e.name).join(", ");return{content:[{type:"text",text:`🔄 "${r.name}" を再起動しました（ツール${s.length}個）\n\nツール: ${i||"(なし)"}`}]}}if("unregister_service"===r){const{service_id:e}=o;if(!TOKEN)return{content:[{type:"text",text:"🔒 未認証です。ログインが必要です。"}],isError:!0};this.childManager.isActive(e)&&(this.childManager.deactivate(e),log(`[unregister] "${e}" stopped`));const t=await uninstallMcpService(e,TOKEN);if(!t.success)return{content:[{type:"text",text:`❌ "${e}" のサーバー削除に失敗: ${t.error||"Unknown"}`}],isError:!0};log(`[unregister] "${e}" uninstalled from server`);try{await this.server.notification({method:"notifications/tools/list_changed"})}catch(e){log(`[unregister] notification error: ${e.message}`)}return{content:[{type:"text",text:`🗑️ "${e}" を削除しました。プロセスも停止済みです。`}]}}if("register_service"===r){const e=this.checkAuth();if(!e.ok)return{content:[{type:"text",text:`🔒 ${e.error}`}],isError:!0};const{service_id:t,env:r}=o;if(!TOKEN)return{content:[{type:"text",text:"🔒 未認証です。ログインが必要です。"}],isError:!0};const s=r||{},i=await installMcpService(t,!1,TOKEN,s);return i.success?(log(`[register] "${t}" installed on server`),{content:[{type:"text",text:`✅ サービス "${t}" をサーバーに登録しました。\n\n次のステップ:\n- save_mcp_env で APIキー等を設定\n- activate_service で有効化`}]}):{content:[{type:"text",text:`❌ "${t}" の登録に失敗しました: ${i.error||"Unknown"}\n\n※ MCP はサーバーカタログに登録されている必要があります。browse_mcp_store で確認してください。`}],isError:!0}}if("save_mcp_env"===r){const e=this.checkAuth();if(!e.ok)return{content:[{type:"text",text:`🔒 ${e.error}`}],isError:!0};const{service_id:t,env:r}=o;if(!t||!r||0===Object.keys(r).length)return{content:[{type:"text",text:"❌ service_id と env（キー/値のペア）が必要です"}],isError:!0};log(`[save_mcp_env] ${t}: ${Object.keys(r).join(", ")}`);try{const e=await updateMcpEnv(t,r,TOKEN);return e.success?{content:[{type:"text",text:`🔐 環境変数をサーバーに保存しました\n\nサービス: ${t}\n保存キー: ${Object.keys(r).join(", ")}\n\n※ ローカルには保存されません。次回起動時にサーバーから自動取得されます。`}]}:{content:[{type:"text",text:`❌ サーバー保存失敗: ${e.error}`}],isError:!0}}catch(e){return log(`[save_mcp_env] error: ${e.message}`),{content:[{type:"text",text:`❌ ${e.message}`}],isError:!0}}}if("browse_mcp_store"===r){const{category:e}=o||{};log(`[browse_mcp_store] category=${e||"all"}`);try{const t=e?{category:e}:{},r=await listAvailableMcps(t,TOKEN,LANGUAGE);if(!r||!r.success)return{content:[{type:"text",text:`❌ MCPカタログの取得に失敗: ${r?.error||"Unknown"}`}],isError:!0};const o=r.data||[];if(0===o.length)return{content:[{type:"text",text:"📦 インストール可能なMCPはありません。"}]};let s=`📦 MCPストア一覧 (${o.length}件)\n\n`;return o.forEach(e=>{const t=e.hasAccess?"✅":"🔒",r=e.isOfficial?" [公式]":"";s+=`${t} **${e.name}**${r}\n`,s+=`  ID: ${e.mcpId}\n`,s+=`  ${e.description}\n`,s+=`  カテゴリ: ${e.category} | ツール数: ${e.toolCount}\n\n`}),s+='\nインストールするには: install_from_store(mcp_id: "MCP_ID")',{content:[{type:"text",text:s}]}}catch(e){return log(`[browse_mcp_store] error: ${e.message}`),{content:[{type:"text",text:`❌ ${e.message}`}],isError:!0}}}if("install_from_store"===r){const{mcp_id:e}=o;log(`[install_from_store] mcp_id=${e}`);try{const t=await downloadMcpPackage(e,TOKEN);if(!t||!t.success)return{content:[{type:"text",text:`❌ MCPダウンロードに失敗: ${t?.error||"Unknown"}`}],isError:!0};const r=t.data,o=r.packageSource||{},s=r.files||[];let i=o.hostingType||o.hosting&&o.hosting.type||null;if(TOKEN){const t=await installMcpService(e,!1,TOKEN);if(!t.success)return{content:[{type:"text",text:`❌ サーバー登録失敗: ${t.error||"Unknown"}`}],isError:!0};if(log(`[install_from_store] Server sync OK: ${e}`),!i){const t=await getGatewayConfig(TOKEN);if(t.success){const r=(t.data?.services||[]).find(t=>t.mcpId===e);r&&(i=r.hostingType)}}}if("cloud_proxy"===i){log(`[install_from_store] "${e}" is cloud_proxy, skipping local extract`);let t=`✅ MCP「${o.name||e}」をインストールしました（cloud_proxy）\n\n`;return t+="☁ クラウド実行のためローカル展開は不要です\n",o.installNotes&&(t+=`\n📝 ${o.installNotes}\n`),t+=`\nactivate_service(service_id: "${e}") で有効化できます。`,{content:[{type:"text",text:t}]}}if(0===s.length)return{content:[{type:"text",text:"❌ MCPパッケージにファイルが含まれていません。"}],isError:!0};const n=path.join(os.homedir(),".claude","mcp-servers",e);fs.mkdirSync(n,{recursive:!0});for(const e of s){const t=path.join(n,e.path);if(fs.mkdirSync(path.dirname(t),{recursive:!0}),fs.writeFileSync(t,e.content,"utf-8"),"number"==typeof e.mode)try{fs.chmodSync(t,511&e.mode)}catch(e){}}if(log(`[install_from_store] ${s.length} files written to ${n}`),o.needsNpmInstall&&fs.existsSync(path.join(n,"package.json"))){const{execSync:e}=require("child_process");try{e("npm install --production",{cwd:n,timeout:6e4,stdio:"pipe"})}catch(e){return{content:[{type:"text",text:`⚠️ ファイル展開完了、npm install失敗: ${e.message}`}]}}}let c=`✅ MCP「${o.name||e}」をインストールしました\n\n`;c+=`📁 インストール先: ${n}\n`,c+=`📄 ファイル数: ${s.length}\n`,o.installNotes&&(c+=`\n📝 ${o.installNotes}\n`);const a=(o.requiredEnvVars||[]).filter(e=>!process.env[e]);return a.length>0&&(c+="\n⚠️ 以下の環境変数を save_mcp_env で設定してください:\n",a.forEach(e=>{c+=`  - ${e}\n`})),c+=`\nactivate_service(service_id: "${e}") で有効化できます。`,{content:[{type:"text",text:c}]}}catch(e){return log(`[install_from_store] error: ${e.message}`),{content:[{type:"text",text:`❌ ${e.message}`}],isError:!0}}}if(this._cloudProxyTools&&this._cloudProxyTools.has(r)){const e=this._cloudProxyTools.get(r);log(`[callTool] Cloud proxy: ${r} → ${e.mcpId}/${e.toolName}`);try{const t=await callMcpToolProxy(e.mcpId,e.toolName,o,TOKEN);return t.success&&t.data?t.data.content?t.data:{content:[{type:"text",text:JSON.stringify(t.data,null,2)}]}:{content:[{type:"text",text:`❌ プロキシエラー: ${t.error||"Unknown"}`}],isError:!0}}catch(e){return log(`[callTool] Cloud proxy error "${r}": ${e.message}`),{content:[{type:"text",text:`❌ クラウドプロキシエラー: ${e.message}`}],isError:!0}}}try{const{found:e,result:t}=await this.childManager.callTool(r,o);if(e)return t&&t.content?t:{content:[{type:"text",text:String(t)}]}}catch(e){return log(`[callTool] Error proxying "${r}": ${e.message}`),{content:[{type:"text",text:`❌ ツール実行エラー: ${e.message}`}],isError:!0}}return{content:[{type:"text",text:`❌ Unknown tool: ${r}`}],isError:!0}})}async autoActivate(){if(!TOKEN)return void log("[autoActivate] No token, skipping auto-activation");let e=[];try{const t=await getGatewayConfig(TOKEN);if(!t.success)return void log(`[autoActivate] Server config failed: ${t.error||"Unknown"}. Starting with no services.`);e=t.data?.services||[],log(`[autoActivate] Server config: ${e.length} services`)}catch(e){return void log(`[autoActivate] Server config error: ${e.message}. Starting with no services.`)}for(const t of e)if(t.alwaysOn)if("cloud_proxy"===t.hostingType){const e=Array.isArray(t.tools)?t.tools:[];if(0===e.length){log(`[autoActivate] "${t.mcpId}" (cloud_proxy) has no tools, skipping`);continue}for(const r of e){const e=`${t.mcpId}__${r.name}`;this._cloudProxyTools=this._cloudProxyTools||new Map,this._cloudProxyTools.set(e,{mcpId:t.mcpId,toolName:r.name,description:r.description,inputSchema:r.inputSchema})}log(`[autoActivate] "${t.mcpId}" (cloud_proxy) → ${e.length} proxy tools registered`)}else{const e=path.join(os.homedir(),".claude","mcp-servers",t.mcpId),r=t.entryPoint||"dist/index.js",o={name:t.name,description:t.description,type:"external",command:t.command||"node",args:t.args&&t.args.length?t.args:[path.join(e,r)],env:t.env||{}};log(`[autoActivate] Activating "${t.mcpId}" (${t.hostingType})...`);try{const e=await this.childManager.activateExternal(t.mcpId,o);log(`[autoActivate] "${t.mcpId}" ready: ${e.length} tools`)}catch(e){log(`[autoActivate] "${t.mcpId}" failed: ${e.message}`)}}}async run(){const e=new StdioServerTransport;if(await this.server.connect(e),log("[Gateway] BlueLamp Gateway v2.0.0 started."),await this.autoActivate(),this.childManager.getActiveServiceIds().length>0)try{await this.server.notification({method:"notifications/tools/list_changed"}),log("[Gateway] Initial list_changed sent after autoActivate.")}catch(e){log(`[Gateway] Initial list_changed error: ${e.message}`)}if(KEYWORD&&TOKEN){log(`[Gateway] Auto-loading knowledge for keyword: ${KEYWORD}`);const e=await getPromptFromPortal(KEYWORD,TOKEN,LANGUAGE);e&&e.success?log(`[Gateway] Auto-load successful: ${e.title}`):log(`[Gateway] Auto-load failed for keyword: ${KEYWORD}`)}}}const server=new BlueLampServer;server.run().catch(e=>{log(`[Gateway] Fatal: ${e.message}`),process.exit(1)});
+
+/**
+ * BlueLamp MCP Server with Gateway
+ * Claude Code専用のMCPサーバー + MCPゲートウェイ統合実装
+ *
+ * 常時ツール:
+ *   - load_knowledge: プロジェクト知識読み込み
+ *   - search_mcp: ローカルregistry検索
+ *   - activate_service: サービス有効化 → tools/list_changed
+ *   - deactivate_service: サービス無効化 → tools/list_changed
+ *   - register_service: 新サービス登録
+ *
+ * autoActivate:
+ *   - playwright, password-manager（起動時に自動有効化）
+ *
+ * オンデマンド:
+ *   - browse_mcp_store: Portal DBカタログ閲覧
+ *   - install_from_store: Portal DBからDL+registry登録
+ *   - gmail, ms365, whisper 等（activate_serviceで有効化）
+ */
+
+const { Server } = require('@modelcontextprotocol/sdk/server/index.js');
+const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
+const {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} = require('@modelcontextprotocol/sdk/types.js');
+const { getPromptFromPortal, listAvailableMcps, downloadMcpPackage, getGatewayConfig, searchMcpServices, installMcpService, setServiceAlwaysOn, uninstallMcpService, updateMcpEnv, callMcpToolProxy } = require('./portal-api-client.cjs');
+const { logger } = require('../utils/logger');
+const { t, setLanguage } = require('../i18n');
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+// .envファイルを読み込み（.env.localを優先）
+const dotenvLocalPath = path.join(__dirname, '../../.env.local');
+const dotenvPath = path.join(__dirname, '../../.env');
+
+if (fs.existsSync(dotenvLocalPath)) {
+  require('dotenv').config({ path: dotenvLocalPath });
+  logger.debug('[MCP Server] Loaded .env.local');
+} else if (fs.existsSync(dotenvPath)) {
+  require('dotenv').config({ path: dotenvPath });
+  logger.debug('[MCP Server] Loaded .env');
+}
+
+// 環境変数から取得
+const KEYWORD = process.env.MUSUHI_KEYWORD || 'BL-要件定義';
+const TOKEN = process.env.MUSUHI_TOKEN;
+const isDevEnv = process.env.NODE_ENV === 'development' || (process.env.PORTAL_URL && process.env.PORTAL_URL.includes('localhost'));
+const PORTAL_URL = process.env.PORTAL_URL || (isDevEnv ? 'http://localhost:8432' : 'https://motohi-api-235426778039.asia-northeast1.run.app');
+const LANGUAGE = process.env.MUSUHI_LANGUAGE || 'ja';
+
+setLanguage(LANGUAGE);
+
+// ログファイル設定
+const LOG_DIR = path.join(os.homedir(), '.bluelamp-vscode', 'logs');
+const LOG_FILE = path.join(LOG_DIR, 'mcp.log');
+if (!fs.existsSync(LOG_DIR)) {
+  fs.mkdirSync(LOG_DIR, { recursive: true });
+}
+
+function log(message) {
+  const timestamp = new Date().toISOString();
+  const logMessage = `[${timestamp}] ${message}\n`;
+  fs.appendFileSync(LOG_FILE, logMessage);
+  logger.info(`[MCP Server] ${message}`);
+}
+
+log(`MCP Server started - Log file: ${LOG_FILE}`);
+log(`Environment variables:`);
+log(`  KEYWORD: ${KEYWORD}`);
+log(`  TOKEN: ${TOKEN ? TOKEN.substring(0, 20) + '...' : 'NOT SET'}`);
+log(`  PORTAL_URL: ${PORTAL_URL}`);
+log(`  LANGUAGE: ${LANGUAGE}`);
+
+// Phase 3-3: 旧 ~/.bluelamp/registry.json を削除（サーバーDB一元化、ローカル残骸を排除）
+const LEGACY_REGISTRY = path.join(os.homedir(), '.bluelamp', 'registry.json');
+if (fs.existsSync(LEGACY_REGISTRY)) {
+  try {
+    fs.unlinkSync(LEGACY_REGISTRY);
+    log(`[startup] Legacy registry.json removed: ${LEGACY_REGISTRY}`);
+  } catch (e) {
+    log(`[startup] Failed to remove legacy registry.json: ${e.message}`);
+  }
+}
+
+// ========================================
+// 子MCPプロセス管理
+// ========================================
+class ChildMcpProcess {
+  constructor(serviceId, command, args, env) {
+    this.serviceId = serviceId;
+    this.command = command;
+    // チルダ(~)をホームディレクトリに展開（cwdに依存しないように）
+    this.args = (args || []).map(a => typeof a === 'string' ? a.replace(/^~\//, os.homedir() + '/') : a);
+    this.env = { ...process.env, ...env };
+    this.process = null;
+    this.tools = [];
+    this.requestId = 0;
+    this.pending = new Map();
+    this.buffer = '';
+  }
+
+  async start() {
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error(`Timeout: "${this.serviceId}" failed to start within 30s`));
+        this.stop();
+      }, 30000);
+
+      try {
+        this.process = spawn(this.command, this.args, {
+          env: this.env,
+          stdio: ['pipe', 'pipe', 'pipe'],
+        });
+
+        this.process.on('error', (err) => {
+          clearTimeout(timeout);
+          reject(new Error(`Spawn error for "${this.serviceId}": ${err.message}`));
+        });
+
+        this.process.on('exit', (code, signal) => {
+          log(`[ChildMcp] "${this.serviceId}" exited (code=${code}, signal=${signal})`);
+          this.pending.forEach(p => p.reject(new Error('Process exited')));
+          this.pending.clear();
+        });
+
+        this.process.stderr.on('data', (data) => {
+          log(`[ChildMcp:${this.serviceId}:stderr] ${data.toString().trim()}`);
+        });
+
+        this.process.stdout.on('data', (data) => {
+          this.buffer += data.toString();
+          this._processBuffer();
+        });
+
+        // initialize → tools/list
+        this._sendRequest('initialize', {
+          protocolVersion: '2024-11-05',
+          capabilities: {},
+          clientInfo: { name: 'bluelamp-gateway', version: '1.0.0' },
+        }).then((initResult) => {
+          log(`[ChildMcp] "${this.serviceId}" initialized: ${JSON.stringify(initResult.serverInfo || {})}`);
+          this._sendNotification('notifications/initialized', {});
+          return this._sendRequest('tools/list', {});
+        }).then((toolsResult) => {
+          const rawTools = toolsResult.tools || [];
+          this.tools = rawTools.map(t => ({
+            ...t,
+            name: `${this.serviceId}__${t.name}`,
+            _originalName: t.name,
+          }));
+          log(`[ChildMcp] "${this.serviceId}" ready: ${this.tools.length} tools`);
+          clearTimeout(timeout);
+          resolve(this.tools);
+        }).catch((err) => {
+          clearTimeout(timeout);
+          reject(err);
+        });
+      } catch (err) {
+        clearTimeout(timeout);
+        reject(err);
+      }
+    });
+  }
+
+  async callTool(originalToolName, args) {
+    return await this._sendRequest('tools/call', {
+      name: originalToolName,
+      arguments: args,
+    });
+  }
+
+  stop() {
+    if (this.process) {
+      this.process.kill();
+      this.process = null;
+    }
+    this.pending.forEach(p => p.reject(new Error('Process stopped')));
+    this.pending.clear();
+  }
+
+  _sendRequest(method, params) {
+    return new Promise((resolve, reject) => {
+      const id = ++this.requestId;
+      const msg = JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n';
+      this.pending.set(id, { resolve, reject });
+      try {
+        this.process.stdin.write(msg);
+      } catch (err) {
+        this.pending.delete(id);
+        reject(new Error(`Write error: ${err.message}`));
+      }
+    });
+  }
+
+  _sendNotification(method, params) {
+    const msg = JSON.stringify({ jsonrpc: '2.0', method, params }) + '\n';
+    try {
+      this.process.stdin.write(msg);
+    } catch (err) {
+      log(`[ChildMcp] Notification write error: ${err.message}`);
+    }
+  }
+
+  _processBuffer() {
+    const lines = this.buffer.split('\n');
+    this.buffer = lines.pop();
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        const msg = JSON.parse(trimmed);
+        if (msg.id && this.pending.has(msg.id)) {
+          const p = this.pending.get(msg.id);
+          this.pending.delete(msg.id);
+          if (msg.error) {
+            p.reject(new Error(`JSON-RPC error: ${JSON.stringify(msg.error)}`));
+          } else {
+            p.resolve(msg.result);
+          }
+        }
+      } catch (e) {
+        log(`[ChildMcp:${this.serviceId}] Parse error: ${e.message} | line: ${trimmed.substring(0, 200)}`);
+      }
+    }
+  }
+}
+
+class ChildMcpManager {
+  constructor() {
+    this.children = new Map();
+  }
+
+  async activateExternal(serviceId, service) {
+    const child = new ChildMcpProcess(
+      serviceId,
+      service.command,
+      service.args || [],
+      service.env || {},
+    );
+    const tools = await child.start();
+    this.children.set(serviceId, {
+      type: 'external',
+      process: child,
+      tools,
+      service,
+    });
+    return tools;
+  }
+
+  deactivate(serviceId) {
+    const child = this.children.get(serviceId);
+    if (!child) return;
+    if (child.type === 'external' && child.process) {
+      child.process.stop();
+    }
+    this.children.delete(serviceId);
+  }
+
+  isActive(serviceId) {
+    return this.children.has(serviceId);
+  }
+
+  getActiveTools() {
+    const tools = [];
+    for (const child of this.children.values()) {
+      tools.push(...(child.tools || []));
+    }
+    return tools;
+  }
+
+  async callTool(toolName, args) {
+    for (const [serviceId, child] of this.children) {
+      if (child.type === 'external') {
+        const tool = child.tools.find(t => t.name === toolName);
+        if (tool) {
+          const result = await child.process.callTool(tool._originalName, args);
+          return { found: true, result };
+        }
+      }
+    }
+    return { found: false };
+  }
+
+  getActiveServiceIds() {
+    return [...this.children.keys()];
+  }
+}
+
+// ========================================
+// BlueLamp MCPサーバー + ゲートウェイ
+// ========================================
+class BlueLampServer {
+  constructor() {
+    this.childManager = new ChildMcpManager();
+
+    this.server = new Server(
+      { name: 'bluelamp', version: '2.0.0' },
+      {
+        capabilities: {
+          tools: { listChanged: true },
+        },
+      }
+    );
+
+    this.setupHandlers();
+  }
+
+  checkAuth() {
+    if (!TOKEN) {
+      return { ok: false, error: 'MUSUHI_TOKEN が設定されていません。BlueLampにログインしてください。' };
+    }
+    return { ok: true };
+  }
+
+  buildToolList() {
+    const tools = [
+      // --- 常時ツール ---
+      {
+        name: 'load_knowledge',
+        description: t('mcp.toolDescriptionLoadKnowledge'),
+        annotations: { readOnlyHint: true, idempotentHint: true },
+        inputSchema: {
+          type: 'object',
+          properties: {
+            keyword: { type: 'string', description: t('mcp.keywordDescription') },
+          },
+          required: ['keyword'],
+        },
+      },
+      {
+        name: 'search_mcp',
+        description: 'キーワードでインストール済みMCPサービスを検索します。使いたい機能を自然言語で説明してください。（例: "ブラウザ操作", "メール送信", "画像生成"）',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            query: { type: 'string', description: '検索キーワード（自然言語OK）' },
+          },
+          required: ['query'],
+        },
+      },
+      {
+        name: 'activate_service',
+        description: 'MCPサービスを有効化してツールを追加します。search_mcpで見つけたservice_idを指定してください。always_on: trueで次回以降も自動的に有効化されます。',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            service_id: { type: 'string', description: 'サービスID' },
+            always_on: { type: 'boolean', description: 'trueにすると常時アクティブ（毎回自動起動）になります' },
+          },
+          required: ['service_id'],
+        },
+      },
+      {
+        name: 'deactivate_service',
+        description: 'MCPサービスの常時アクティブ（alwaysOn）設定を解除します。次回起動時から自動有効化されなくなります。',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            service_id: { type: 'string', description: 'サービスID' },
+          },
+          required: ['service_id'],
+        },
+      },
+      {
+        name: 'restart_service',
+        description: 'MCPサービスのプロセスを再起動します。コード更新や設定変更の反映に使用します。',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            service_id: { type: 'string', description: 'サービスID' },
+          },
+          required: ['service_id'],
+        },
+      },
+      {
+        name: 'unregister_service',
+        description: 'MCPサービスをレジストリから完全に削除します。プロセスも停止します。',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            service_id: { type: 'string', description: '削除するサービスID' },
+          },
+          required: ['service_id'],
+        },
+      },
+      {
+        name: 'register_service',
+        description: '新しいMCPサービスをゲートウェイに登録します。',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            service_id: { type: 'string', description: 'サービスID（英数字、例: "microcms"）' },
+            name: { type: 'string', description: 'サービス表示名' },
+            description: { type: 'string', description: 'サービスの説明' },
+            tags: { type: 'array', items: { type: 'string' }, description: '検索用タグ' },
+            command: { type: 'string', description: '実行コマンド（"npx" or "node"）' },
+            args: { type: 'array', items: { type: 'string' }, description: 'コマンド引数' },
+            env: { type: 'object', description: '環境変数' },
+          },
+          required: ['service_id', 'name', 'description', 'tags'],
+        },
+      },
+      {
+        name: 'browse_mcp_store',
+        description: 'MCPストア（Portal）からインストール可能なMCP一覧を取得します。',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            category: { type: 'string', description: 'カテゴリでフィルタ（省略可）' },
+          },
+          required: [],
+        },
+      },
+      {
+        name: 'install_from_store',
+        description: 'MCPストアからMCPをダウンロードしてインストールします。browse_mcp_storeで見つけたmcp_idを指定してください。',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            mcp_id: { type: 'string', description: 'インストールするMCPのID' },
+          },
+          required: ['mcp_id'],
+        },
+      },
+      {
+        name: 'save_mcp_env',
+        description: 'MCPの環境変数（APIキー等）をサーバーに安全に保存します。ローカルには保存されません。次回起動時にサーバーから自動取得されます。解約時はアクセスできなくなります。',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            service_id: { type: 'string', description: 'MCP サービスID（例: heygen, gemini-image）' },
+            env: {
+              type: 'object',
+              description: '環境変数のキーと値（例: {"HEYGEN_API_KEY": "sk_xxx"}）',
+              additionalProperties: { type: 'string' },
+            },
+          },
+          required: ['service_id', 'env'],
+        },
+      },
+    ];
+
+    // アクティブなサービスのツールを追加（子プロセス系）
+    tools.push(...this.childManager.getActiveTools());
+
+    // クラウドプロキシツールを追加（子プロセス不要系）
+    if (this._cloudProxyTools) {
+      for (const [proxyName, info] of this._cloudProxyTools) {
+        tools.push({
+          name: proxyName,
+          description: info.description || `[${info.mcpId}] ${info.toolName}`,
+          inputSchema: info.inputSchema || { type: 'object', properties: {} },
+        });
+      }
+    }
+
+    return tools;
+  }
+
+  setupHandlers() {
+    // ツール一覧
+    this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+      const tools = this.buildToolList();
+      const active = this.childManager.getActiveServiceIds();
+      log(`[ListTools] ${tools.length} tools (active: ${active.join(', ') || 'none'})`);
+      return { tools };
+    });
+
+    // ツール実行
+    this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+      const { name, arguments: args } = request.params;
+      log(`[CallTool] ${name}`);
+
+      // --- load_knowledge ---
+      if (name === 'load_knowledge') {
+        const { keyword } = args;
+        log(`[load_knowledge] keyword: ${keyword}`);
+        try {
+          const result = await getPromptFromPortal(keyword, TOKEN, LANGUAGE);
+          if (!result || !result.success) {
+            const errorMessage = result?.error || t('mcp.knowledgeNotFound', { keyword });
+            return { content: [{ type: 'text', text: `❌ ${t('mcp.portalApiFailed', { error: errorMessage })}` }], isError: true };
+          }
+          const langInstruction = LANGUAGE !== 'ja' ? `\n\n[Note] The user's preferred language is English.` : '';
+          return {
+            content: [{
+              type: 'text',
+              text: `✅ ${t('mcp.knowledgeLoadSuccess')}\n\n${result.knowledge}${langInstruction}\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n${t('mcp.knowledgeApplied')}`,
+            }],
+          };
+        } catch (error) {
+          log(`[load_knowledge] Exception: ${error.message}`);
+          return { content: [{ type: 'text', text: `❌ ${t('mcp.knowledgeLoadError', { error: error.message })}` }], isError: true };
+        }
+      }
+
+      // --- search_mcp ---
+      if (name === 'search_mcp') {
+        const auth = this.checkAuth();
+        if (!auth.ok) {
+          return { content: [{ type: 'text', text: `🔒 ${auth.error}` }], isError: true };
+        }
+
+        if (!TOKEN) {
+          return { content: [{ type: 'text', text: `❌ 未認証です。MCPカタログの検索にはログインが必要です。` }], isError: true };
+        }
+
+        let results = [];
+        try {
+          const serverResult = await searchMcpServices(args.query, TOKEN);
+          if (!serverResult.success) {
+            return { content: [{ type: 'text', text: `❌ MCPカタログ検索に失敗: ${serverResult.error || 'Unknown'}` }], isError: true };
+          }
+          results = (serverResult.data || []).map(r => ({
+            id: r.mcp_id,
+            service: { name: r.name, description: r.description, tags: [], alwaysOn: r.alwaysOn || false },
+            isInstalled: r.isInstalled || false,
+          }));
+        } catch (err) {
+          log(`[search_mcp] Server search failed: ${err.message}`);
+          return { content: [{ type: 'text', text: `❌ MCPカタログ検索に失敗: ${err.message}` }], isError: true };
+        }
+
+        if (results.length === 0) {
+          return {
+            content: [{ type: 'text', text: `🔍 「${args.query}」に一致するサービスはありません。\n\n別のキーワードで試すか、browse_mcp_storeでカタログを確認してください。` }],
+          };
+        }
+
+        let text = `🔍 「${args.query}」の検索結果（${results.length}件）\n\n`;
+        for (const r of results.slice(0, 10)) {
+          const id = r.id;
+          const svc = r.service;
+          const isActive = this.childManager.isActive(id);
+          const isAlwaysOn = svc.alwaysOn;
+          const installed = r.isInstalled ? '' : ' [未インストール]';
+          const status = isAlwaysOn ? '🔒' : isActive ? '🟢' : '⚪';
+          const label = isAlwaysOn ? ' [常時アクティブ]' : '';
+          text += `${status} **${svc.name}**${label}${installed} (id: \`${id}\`)\n`;
+          text += `   ${svc.description}\n\n`;
+        }
+        text += `有効化: activate_service | インストール: install_from_store`;
+        return { content: [{ type: 'text', text }] };
+      }
+
+      // --- activate_service ---
+      if (name === 'activate_service') {
+        const auth = this.checkAuth();
+        if (!auth.ok) {
+          return { content: [{ type: 'text', text: `🔒 ${auth.error}` }], isError: true };
+        }
+
+        const { service_id, always_on } = args;
+
+        // サーバーから service 設定を取得
+        const cfg = await getGatewayConfig(TOKEN);
+        if (!cfg.success) {
+          return { content: [{ type: 'text', text: `❌ サーバー設定の取得に失敗: ${cfg.error || 'Unknown'}` }], isError: true };
+        }
+        const svc = (cfg.data?.services || []).find(s => s.mcpId === service_id);
+
+        if (!svc) {
+          return { content: [{ type: 'text', text: `❌ サービス "${service_id}" はインストールされていません。install_from_storeでインストールしてください。` }], isError: true };
+        }
+
+        if (always_on) {
+          setServiceAlwaysOn(service_id, true, TOKEN).catch(err =>
+            log(`[activate] Server sync failed: ${err.message}`)
+          );
+          log(`[activate] "${service_id}" set alwaysOn: true`);
+        }
+
+        if (this.childManager.isActive(service_id)) {
+          const alwaysOnMsg = always_on ? '（常時アクティブに設定しました）' : '';
+          return { content: [{ type: 'text', text: `ℹ️ "${service_id}" は既に有効です。${alwaysOnMsg}` }] };
+        }
+
+        // cloud_proxy → 子プロセスを起動せず、プロキシツールとして直接登録
+        //（autoActivate と同じロジック）
+        if (svc.hostingType === 'cloud_proxy') {
+          const proxyTools = Array.isArray(svc.tools) ? svc.tools : [];
+          if (proxyTools.length === 0) {
+            return { content: [{ type: 'text', text: `❌ "${service_id}" (cloud_proxy) にツール定義がありません。` }], isError: true };
+          }
+          // 既に同名で登録済みの場合は上書き（再アクティブで安全）
+          this._cloudProxyTools = this._cloudProxyTools || new Map();
+          for (const tool of proxyTools) {
+            const proxyToolName = `${service_id}__${tool.name}`;
+            this._cloudProxyTools.set(proxyToolName, {
+              mcpId: service_id,
+              toolName: tool.name,
+              description: tool.description,
+              inputSchema: tool.inputSchema,
+            });
+          }
+          log(`[activate] "${service_id}" (cloud_proxy) → ${proxyTools.length} proxy tools registered`);
+
+          try {
+            await this.server.notification({ method: 'notifications/tools/list_changed' });
+          } catch (err) {
+            log(`[activate] notification error: ${err.message}`);
+          }
+
+          const toolNames = proxyTools.map(t => `${service_id}__${t.name}`).join(', ');
+          const alwaysOnLabel = always_on ? ' 🔒常時アクティブ' : '';
+          return {
+            content: [{ type: 'text', text: `✅ "${svc.name}" を有効化しました${alwaysOnLabel}（cloud_proxy ツール${proxyTools.length}個追加）\n\n追加ツール: ${toolNames}` }],
+          };
+        }
+
+        // external_api / local → 子プロセス spawn
+        const installDir = path.join(os.homedir(), '.claude', 'mcp-servers', service_id);
+        const entryPoint = svc.entryPoint || 'dist/index.js';
+        const service = {
+          name: svc.name,
+          description: svc.description,
+          type: 'external',
+          command: svc.command || 'node',
+          args: svc.args && svc.args.length ? svc.args : [path.join(installDir, entryPoint)],
+          env: svc.env || {},
+        };
+
+        let addedTools;
+        try {
+          addedTools = await this.childManager.activateExternal(service_id, service);
+        } catch (err) {
+          log(`[activate] Failed "${service_id}": ${err.message}`);
+          return { content: [{ type: 'text', text: `❌ "${service_id}" の起動に失敗しました: ${err.message}` }], isError: true };
+        }
+
+        const toolNames = addedTools.map(t => t.name).join(', ');
+        const alwaysOnLabel = always_on ? ' 🔒常時アクティブ' : '';
+        log(`[activate] "${service_id}" → ${addedTools.length} tools${always_on ? ' (alwaysOn)' : ''}. Sending list_changed.`);
+
+        try {
+          await this.server.notification({ method: 'notifications/tools/list_changed' });
+        } catch (err) {
+          log(`[activate] notification error: ${err.message}`);
+        }
+
+        return {
+          content: [{ type: 'text', text: `✅ "${service.name}" を有効化しました${alwaysOnLabel}（ツール${addedTools.length}個追加）\n\n追加ツール: ${toolNames || '(なし)'}` }],
+        };
+      }
+
+      // --- deactivate_service ---
+      if (name === 'deactivate_service') {
+        const { service_id } = args;
+
+        if (!TOKEN) {
+          return { content: [{ type: 'text', text: `🔒 未認証です。ログインが必要です。` }], isError: true };
+        }
+
+        const result = await setServiceAlwaysOn(service_id, false, TOKEN);
+        if (!result.success) {
+          return { content: [{ type: 'text', text: `❌ "${service_id}" の解除に失敗: ${result.error || 'Unknown'}` }], isError: true };
+        }
+        log(`[deactivate] "${service_id}" set alwaysOn: false`);
+
+        // cloud_proxy: 登録済みプロキシツールを Map から削除 → list_changed 通知
+        let removedCount = 0;
+        if (this._cloudProxyTools) {
+          const prefix = `${service_id}__`;
+          for (const key of [...this._cloudProxyTools.keys()]) {
+            if (key.startsWith(prefix)) {
+              this._cloudProxyTools.delete(key);
+              removedCount++;
+            }
+          }
+          if (removedCount > 0) {
+            log(`[deactivate] "${service_id}" (cloud_proxy) → ${removedCount} proxy tools removed`);
+          }
+        }
+
+        // external_api / local: 子プロセスが動いていれば停止
+        let stoppedChild = false;
+        if (this.childManager.isActive(service_id)) {
+          this.childManager.deactivate(service_id);
+          log(`[deactivate] "${service_id}" child process stopped`);
+          stoppedChild = true;
+        }
+
+        // ツール一覧が変化した場合のみ list_changed を送る
+        if (removedCount > 0 || stoppedChild) {
+          try {
+            await this.server.notification({ method: 'notifications/tools/list_changed' });
+          } catch (err) {
+            log(`[deactivate] notification error: ${err.message}`);
+          }
+        }
+
+        let text = `✅ "${service_id}" の常時アクティブを解除しました。`;
+        if (removedCount > 0) text += ` cloud_proxy ツール${removedCount}個を削除しました。`;
+        if (stoppedChild) text += ` 子プロセスを停止しました。`;
+        text += ` 次回起動時から自動有効化されません。`;
+        return { content: [{ type: 'text', text }] };
+      }
+
+      // --- restart_service ---
+      if (name === 'restart_service') {
+        const { service_id } = args;
+
+        // アクティブな子プロセスから設定を取得（activateExternal 時に保存済み）
+        const child = this.childManager.children.get(service_id);
+        const service = child?.service;
+
+        if (!service) {
+          return { content: [{ type: 'text', text: `❌ "${service_id}" は現在アクティブではありません。activate_service で有効化してください。` }], isError: true };
+        }
+
+        // 1. 既存プロセスを停止
+        this.childManager.deactivate(service_id);
+        log(`[restart] "${service_id}" stopped`);
+
+        // 2. 再起動
+        let addedTools;
+        try {
+          addedTools = await this.childManager.activateExternal(service_id, service);
+        } catch (err) {
+          log(`[restart] Failed "${service_id}": ${err.message}`);
+          return { content: [{ type: 'text', text: `❌ "${service_id}" の再起動に失敗しました: ${err.message}` }], isError: true };
+        }
+
+        log(`[restart] "${service_id}" → ${addedTools.length} tools. Sending list_changed.`);
+        try {
+          await this.server.notification({ method: 'notifications/tools/list_changed' });
+        } catch (err) {
+          log(`[restart] notification error: ${err.message}`);
+        }
+
+        const toolNames = addedTools.map(t => t.name).join(', ');
+        return {
+          content: [{ type: 'text', text: `🔄 "${service.name}" を再起動しました（ツール${addedTools.length}個）\n\nツール: ${toolNames || '(なし)'}` }],
+        };
+      }
+
+      // --- unregister_service ---
+      if (name === 'unregister_service') {
+        const { service_id } = args;
+
+        if (!TOKEN) {
+          return { content: [{ type: 'text', text: `🔒 未認証です。ログインが必要です。` }], isError: true };
+        }
+
+        // 1. プロセス停止
+        if (this.childManager.isActive(service_id)) {
+          this.childManager.deactivate(service_id);
+          log(`[unregister] "${service_id}" stopped`);
+        }
+
+        // 2. サーバーからアンインストール
+        const result = await uninstallMcpService(service_id, TOKEN);
+        if (!result.success) {
+          return { content: [{ type: 'text', text: `❌ "${service_id}" のサーバー削除に失敗: ${result.error || 'Unknown'}` }], isError: true };
+        }
+        log(`[unregister] "${service_id}" uninstalled from server`);
+
+        try {
+          await this.server.notification({ method: 'notifications/tools/list_changed' });
+        } catch (err) {
+          log(`[unregister] notification error: ${err.message}`);
+        }
+
+        return {
+          content: [{ type: 'text', text: `🗑️ "${service_id}" を削除しました。プロセスも停止済みです。` }],
+        };
+      }
+
+      // --- register_service ---
+      if (name === 'register_service') {
+        const auth = this.checkAuth();
+        if (!auth.ok) {
+          return { content: [{ type: 'text', text: `🔒 ${auth.error}` }], isError: true };
+        }
+
+        const { service_id, env } = args;
+
+        if (!TOKEN) {
+          return { content: [{ type: 'text', text: `🔒 未認証です。ログインが必要です。` }], isError: true };
+        }
+
+        const envObj = env || {};
+        const installResult = await installMcpService(service_id, false, TOKEN, envObj);
+
+        if (!installResult.success) {
+          return {
+            content: [{ type: 'text', text: `❌ "${service_id}" の登録に失敗しました: ${installResult.error || 'Unknown'}\n\n※ MCP はサーバーカタログに登録されている必要があります。browse_mcp_store で確認してください。` }],
+            isError: true,
+          };
+        }
+
+        log(`[register] "${service_id}" installed on server`);
+
+        return {
+          content: [{ type: 'text', text: `✅ サービス "${service_id}" をサーバーに登録しました。\n\n次のステップ:\n- save_mcp_env で APIキー等を設定\n- activate_service で有効化` }],
+        };
+      }
+
+      // --- save_mcp_env ---
+      if (name === 'save_mcp_env') {
+        const auth = this.checkAuth();
+        if (!auth.ok) {
+          return { content: [{ type: 'text', text: `🔒 ${auth.error}` }], isError: true };
+        }
+
+        const { service_id, env } = args;
+        if (!service_id || !env || Object.keys(env).length === 0) {
+          return { content: [{ type: 'text', text: '❌ service_id と env（キー/値のペア）が必要です' }], isError: true };
+        }
+
+        log(`[save_mcp_env] ${service_id}: ${Object.keys(env).join(', ')}`);
+
+        try {
+          const result = await updateMcpEnv(service_id, env, TOKEN);
+          if (!result.success) {
+            return { content: [{ type: 'text', text: `❌ サーバー保存失敗: ${result.error}` }], isError: true };
+          }
+
+          const keys = Object.keys(env).join(', ');
+          return {
+            content: [{ type: 'text', text: `🔐 環境変数をサーバーに保存しました\n\nサービス: ${service_id}\n保存キー: ${keys}\n\n※ ローカルには保存されません。次回起動時にサーバーから自動取得されます。` }],
+          };
+        } catch (error) {
+          log(`[save_mcp_env] error: ${error.message}`);
+          return { content: [{ type: 'text', text: `❌ ${error.message}` }], isError: true };
+        }
+      }
+
+      // --- browse_mcp_store (旧 list_mcps) ---
+      if (name === 'browse_mcp_store') {
+        const { category } = args || {};
+        log(`[browse_mcp_store] category=${category || 'all'}`);
+        try {
+          const options = category ? { category } : {};
+          const result = await listAvailableMcps(options, TOKEN, LANGUAGE);
+          if (!result || !result.success) {
+            return { content: [{ type: 'text', text: `❌ MCPカタログの取得に失敗: ${result?.error || 'Unknown'}` }], isError: true };
+          }
+          const mcps = result.data || [];
+          if (mcps.length === 0) {
+            return { content: [{ type: 'text', text: '📦 インストール可能なMCPはありません。' }] };
+          }
+          let text = `📦 MCPストア一覧 (${mcps.length}件)\n\n`;
+          mcps.forEach(mcp => {
+            const access = mcp.hasAccess ? '✅' : '🔒';
+            const official = mcp.isOfficial ? ' [公式]' : '';
+            text += `${access} **${mcp.name}**${official}\n`;
+            text += `  ID: ${mcp.mcpId}\n`;
+            text += `  ${mcp.description}\n`;
+            text += `  カテゴリ: ${mcp.category} | ツール数: ${mcp.toolCount}\n\n`;
+          });
+          text += `\nインストールするには: install_from_store(mcp_id: "MCP_ID")`;
+          return { content: [{ type: 'text', text }] };
+        } catch (error) {
+          log(`[browse_mcp_store] error: ${error.message}`);
+          return { content: [{ type: 'text', text: `❌ ${error.message}` }], isError: true };
+        }
+      }
+
+      // --- install_from_store (旧 install_mcp) ---
+      if (name === 'install_from_store') {
+        const { mcp_id } = args;
+        log(`[install_from_store] mcp_id=${mcp_id}`);
+        try {
+          const result = await downloadMcpPackage(mcp_id, TOKEN);
+          if (!result || !result.success) {
+            return { content: [{ type: 'text', text: `❌ MCPダウンロードに失敗: ${result?.error || 'Unknown'}` }], isError: true };
+          }
+
+          const pkg = result.data;
+          const pkgSource = pkg.packageSource || {};
+          const files = pkg.files || [];
+
+          // cloud_proxy 判定: packageSource.hostingType（バックエンド v2+）を優先。
+          // 未提供の旧バックエンドではサーバー登録後に getGatewayConfig で判定する。
+          let hostingType = pkgSource.hostingType || (pkgSource.hosting && pkgSource.hosting.type) || null;
+
+          // サーバーにインストール登録（ユーザーの UserMcpInstallation に追加）
+          // cloud_proxy 判定のために先に登録しておく（hostingType 取得目的も兼ねる）
+          if (TOKEN) {
+            const installResult = await installMcpService(mcp_id, false, TOKEN);
+            if (!installResult.success) {
+              return { content: [{ type: 'text', text: `❌ サーバー登録失敗: ${installResult.error || 'Unknown'}` }], isError: true };
+            }
+            log(`[install_from_store] Server sync OK: ${mcp_id}`);
+
+            // hostingType が packageSource に無かった場合、gateway-config から取得
+            if (!hostingType) {
+              const cfg = await getGatewayConfig(TOKEN);
+              if (cfg.success) {
+                const svc = (cfg.data?.services || []).find(s => s.mcpId === mcp_id);
+                if (svc) hostingType = svc.hostingType;
+              }
+            }
+          }
+
+          // cloud_proxy は子プロセス不要 → ローカル展開スキップ（ゲートウェイがプロキシ転送）
+          if (hostingType === 'cloud_proxy') {
+            log(`[install_from_store] "${mcp_id}" is cloud_proxy, skipping local extract`);
+            let text = `✅ MCP「${pkgSource.name || mcp_id}」をインストールしました（cloud_proxy）\n\n`;
+            text += `☁ クラウド実行のためローカル展開は不要です\n`;
+            if (pkgSource.installNotes) text += `\n📝 ${pkgSource.installNotes}\n`;
+            text += `\nactivate_service(service_id: "${mcp_id}") で有効化できます。`;
+            return { content: [{ type: 'text', text }] };
+          }
+
+          // external_api / local: ファイル展開が必要
+          if (files.length === 0) {
+            return { content: [{ type: 'text', text: '❌ MCPパッケージにファイルが含まれていません。' }], isError: true };
+          }
+
+          // ファイル展開
+          const installDir = path.join(os.homedir(), '.claude', 'mcp-servers', mcp_id);
+          fs.mkdirSync(installDir, { recursive: true });
+          for (const file of files) {
+            const filePath = path.join(installDir, file.path);
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, file.content, 'utf-8');
+            if (typeof file.mode === 'number') {
+              try { fs.chmodSync(filePath, file.mode & 0o777); } catch (_) { /* swallow */ }
+            }
+          }
+          log(`[install_from_store] ${files.length} files written to ${installDir}`);
+
+          // npm install
+          if (pkgSource.needsNpmInstall && fs.existsSync(path.join(installDir, 'package.json'))) {
+            const { execSync } = require('child_process');
+            try {
+              execSync('npm install --production', { cwd: installDir, timeout: 60000, stdio: 'pipe' });
+            } catch (npmError) {
+              return { content: [{ type: 'text', text: `⚠️ ファイル展開完了、npm install失敗: ${npmError.message}` }] };
+            }
+          }
+
+          let text = `✅ MCP「${pkgSource.name || mcp_id}」をインストールしました\n\n`;
+          text += `📁 インストール先: ${installDir}\n`;
+          text += `📄 ファイル数: ${files.length}\n`;
+          if (pkgSource.installNotes) text += `\n📝 ${pkgSource.installNotes}\n`;
+          const requiredEnvVars = pkgSource.requiredEnvVars || [];
+          const missingVars = requiredEnvVars.filter(v => !process.env[v]);
+          if (missingVars.length > 0) {
+            text += `\n⚠️ 以下の環境変数を save_mcp_env で設定してください:\n`;
+            missingVars.forEach(v => { text += `  - ${v}\n`; });
+          }
+          text += `\nactivate_service(service_id: "${mcp_id}") で有効化できます。`;
+          return { content: [{ type: 'text', text }] };
+        } catch (error) {
+          log(`[install_from_store] error: ${error.message}`);
+          return { content: [{ type: 'text', text: `❌ ${error.message}` }], isError: true };
+        }
+      }
+
+      // --- クラウドプロキシツール（子プロセス不要、直接サーバーに転送）---
+      if (this._cloudProxyTools && this._cloudProxyTools.has(name)) {
+        const proxyInfo = this._cloudProxyTools.get(name);
+        log(`[callTool] Cloud proxy: ${name} → ${proxyInfo.mcpId}/${proxyInfo.toolName}`);
+        try {
+          const result = await callMcpToolProxy(proxyInfo.mcpId, proxyInfo.toolName, args, TOKEN);
+          if (result.success && result.data) {
+            // callMcpTool のレスポンスは JSON-RPC 形式の可能性がある
+            if (result.data.content) return result.data;
+            return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
+          }
+          return { content: [{ type: 'text', text: `❌ プロキシエラー: ${result.error || 'Unknown'}` }], isError: true };
+        } catch (err) {
+          log(`[callTool] Cloud proxy error "${name}": ${err.message}`);
+          return { content: [{ type: 'text', text: `❌ クラウドプロキシエラー: ${err.message}` }], isError: true };
+        }
+      }
+
+      // --- 動的ツール（アクティブサービスから検索 = 子プロセス経由）---
+      try {
+        const { found, result } = await this.childManager.callTool(name, args);
+        if (found) {
+          if (result && result.content) return result;
+          return { content: [{ type: 'text', text: String(result) }] };
+        }
+      } catch (err) {
+        log(`[callTool] Error proxying "${name}": ${err.message}`);
+        return { content: [{ type: 'text', text: `❌ ツール実行エラー: ${err.message}` }], isError: true };
+      }
+
+      return { content: [{ type: 'text', text: `❌ Unknown tool: ${name}` }], isError: true };
+    });
+  }
+
+  async autoActivate() {
+    // Phase 3-3: サーバーを唯一の真実源として使用
+    // cloud_proxy → プロキシツールとして直接登録（子プロセス不要）
+    // external_api / local → 子プロセス spawn
+    if (!TOKEN) {
+      log(`[autoActivate] No token, skipping auto-activation`);
+      return;
+    }
+
+    let serverServices = [];
+    try {
+      const result = await getGatewayConfig(TOKEN);
+      if (!result.success) {
+        log(`[autoActivate] Server config failed: ${result.error || 'Unknown'}. Starting with no services.`);
+        return;
+      }
+      serverServices = result.data?.services || [];
+      log(`[autoActivate] Server config: ${serverServices.length} services`);
+    } catch (err) {
+      log(`[autoActivate] Server config error: ${err.message}. Starting with no services.`);
+      return;
+    }
+
+    for (const svc of serverServices) {
+      if (!svc.alwaysOn) continue;
+
+      if (svc.hostingType === 'cloud_proxy') {
+        const tools = Array.isArray(svc.tools) ? svc.tools : [];
+        if (tools.length === 0) {
+          log(`[autoActivate] "${svc.mcpId}" (cloud_proxy) has no tools, skipping`);
+          continue;
+        }
+        for (const tool of tools) {
+          const proxyToolName = `${svc.mcpId}__${tool.name}`;
+          this._cloudProxyTools = this._cloudProxyTools || new Map();
+          this._cloudProxyTools.set(proxyToolName, {
+            mcpId: svc.mcpId,
+            toolName: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+          });
+        }
+        log(`[autoActivate] "${svc.mcpId}" (cloud_proxy) → ${tools.length} proxy tools registered`);
+      } else {
+        const installDir = path.join(os.homedir(), '.claude', 'mcp-servers', svc.mcpId);
+        const entryPoint = svc.entryPoint || 'dist/index.js';
+        const service = {
+          name: svc.name,
+          description: svc.description,
+          type: 'external',
+          command: svc.command || 'node',
+          args: svc.args && svc.args.length ? svc.args : [path.join(installDir, entryPoint)],
+          env: svc.env || {},
+        };
+        log(`[autoActivate] Activating "${svc.mcpId}" (${svc.hostingType})...`);
+        try {
+          const tools = await this.childManager.activateExternal(svc.mcpId, service);
+          log(`[autoActivate] "${svc.mcpId}" ready: ${tools.length} tools`);
+        } catch (err) {
+          log(`[autoActivate] "${svc.mcpId}" failed: ${err.message}`);
+        }
+      }
+    }
+  }
+
+  async run() {
+    const transport = new StdioServerTransport();
+    await this.server.connect(transport);
+    log('[Gateway] BlueLamp Gateway v2.0.0 started.');
+
+    // autoActivate処理
+    await this.autoActivate();
+
+    // tools/list_changed を送信（autoActivateで追加されたツールを反映）
+    if (this.childManager.getActiveServiceIds().length > 0) {
+      try {
+        await this.server.notification({ method: 'notifications/tools/list_changed' });
+        log('[Gateway] Initial list_changed sent after autoActivate.');
+      } catch (err) {
+        log(`[Gateway] Initial list_changed error: ${err.message}`);
+      }
+    }
+
+    // 起動時に自動的に知識を読み込み
+    if (KEYWORD && TOKEN) {
+      log(`[Gateway] Auto-loading knowledge for keyword: ${KEYWORD}`);
+      const result = await getPromptFromPortal(KEYWORD, TOKEN, LANGUAGE);
+      if (result && result.success) {
+        log(`[Gateway] Auto-load successful: ${result.title}`);
+      } else {
+        log(`[Gateway] Auto-load failed for keyword: ${KEYWORD}`);
+      }
+    }
+  }
+}
+
+const server = new BlueLampServer();
+
+// === Zombie prevention: cleanup all child MCPs on parent exit ===
+let _blIsShuttingDown = false;
+const _blCleanupChildren = (signal) => {
+  if (_blIsShuttingDown) return;
+  _blIsShuttingDown = true;
+  try { log(`[Gateway] Shutdown (${signal}) - cleaning up children...`); } catch (e) {}
+  if (server && server.childManager && server.childManager.children) {
+    for (const [id, child] of server.childManager.children) {
+      try {
+        try { log(`[Gateway] Stopping child: ${id}`); } catch (e) {}
+        if (child && child.type === 'external' && child.process && typeof child.process.stop === 'function') {
+          child.process.stop();
+        }
+      } catch (e) {}
+    }
+  }
+  setTimeout(() => process.exit(0), 200).unref();
+};
+process.on('SIGTERM', () => _blCleanupChildren('SIGTERM'));
+process.on('SIGINT',  () => _blCleanupChildren('SIGINT'));
+process.on('SIGHUP',  () => _blCleanupChildren('SIGHUP'));
+process.stdin.on('end',   () => _blCleanupChildren('stdin-end'));
+process.stdin.on('close', () => _blCleanupChildren('stdin-close'));
+process.on('exit', () => {
+  if (server && server.childManager && server.childManager.children) {
+    for (const [id, child] of server.childManager.children) {
+      try {
+        if (child && child.process && child.process.process && typeof child.process.process.kill === 'function') {
+          child.process.process.kill('SIGKILL');
+        }
+      } catch (e) {}
+    }
+  }
+});
+// =============================================================
+
+server.run().catch((err) => {
+  log(`[Gateway] Fatal: ${err.message}`);
+  process.exit(1);
+});