@ppdocs/mcp 3.2.1 → 3.2.3

package/dist/cli.d.ts

@@ -2,6 +2,6 @@
  * ppdocs MCP CLI
  * 命令: init - 初始化项目配置 + 安装工作流模板 + 自动注册 MCP
  */
-export declare function runCli(args: string[]): boolean;
+export declare function runCli(args: string[]): Promise<'exit' | 'keep-alive' | false>;
 /** 安装项目模板文件 (供授权后自动配置调用) */
 export declare function setupProjectFiles(cwd: string, apiUrl: string): void;

package/dist/cli.js

@@ -112,7 +112,7 @@ Example:
   npx @ppdocs/mcp init -p myproject -k abc123xyz --sync shared-rules
 `);
 }
-export function runCli(args) {
+export async function runCli(args) {
     const cmd = args[0];
     if (cmd === 'init') {
         const opts = parseArgs(args.slice(1));
@@ -121,23 +121,17 @@ export function runCli(args) {
             showHelp();
             process.exit(1);
         }
-        initProject(opts).catch(e => {
-            console.error(`❌ Init failed: ${e}`);
-            process.exit(1);
-        });
-        return true;
+        await initProject(opts);
+        return 'exit';
     }
-    if (cmd === 'agent') {
-        // 动态导入 Agent 入口
-        import('./agent.js').catch(e => {
-            console.error(`❌ Agent failed: ${e}`);
-            process.exit(1);
-        });
-        return true;
+    if (cmd === 'agent' || cmd === 'webui') {
+        // 动态导入 Agent 入口 (Web UI + 多项目管理) — 长驻进程，不退出
+        await import('./agent.js');
+        return 'keep-alive';
     }
     if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
         showHelp();
-        return true;
+        return 'exit';
     }
     return false; // Not a CLI command, run as MCP server
 }

package/dist/index.js

@@ -21,8 +21,16 @@ const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'
 const VERSION = pkg.version;
 // 检查是否为 CLI 命令
 const args = process.argv.slice(2);
-if (args.length > 0 && runCli(args)) {
-    process.exit(0);
+if (args.length > 0) {
+    const result = await runCli(args);
+    if (result === 'exit')
+        process.exit(0);
+    if (result === 'keep-alive') {
+        // agent/webui 长驻模式，不继续执行 MCP Server
+        // @ts-ignore: 阻止后续 main() 执行
+        await new Promise(() => { }); // 永不 resolve，进程由 agent.ts 的 HTTP 服务保活
+    }
+    // result === false → 继续作为 MCP Server
 }
 // 运行 MCP 服务
 async function main() {

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@ppdocs/mcp",
-  "version": "3.2.1",
+  "version": "3.2.3",
   "description": "ppdocs MCP Server - Knowledge Graph for Claude",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
+    "ppdocs": "dist/index.js",
     "mcp": "dist/index.js",
     "ppdocs-mcp": "dist/index.js",
     "ppdocs-agent": "dist/agent.js"
@@ -46,4 +47,4 @@
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0"
   }
-}
+}