@ppdocs/mcp 3.2.16 → 3.2.18

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -90,7 +90,6 @@ ppdocs MCP CLI
 
 Commands:
   init    Initialize ppdocs config + install workflow templates
-  webui   Start PPDocs Web UI (MCP management + File Sync)
 
 Usage:
   npx @ppdocs/mcp init -p <projectId> -k <key> [options]
@@ -122,16 +121,11 @@ export async function runCli(args) {
             process.exit(1);
         }
         await initProject(opts);
-        return 'exit';
-    }
-    if (cmd === 'webui') {
-        // 动态导入 WebUI 入口 (Web UI + 多项目管理) — 长驻进程，不退出
-        await import('./agent.js');
-        return 'keep-alive';
+        return true;
     }
     if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
         showHelp();
-        return 'exit';
+        return true;
     }
     return false; // Not a CLI command, run as MCP server
 }
@@ -164,15 +158,15 @@ async function initProject(opts) {
         hasIdeDir = true;
     }
     if (detectedIdes.includes('cursor')) {
-        installCursorTemplates(cwd, apiUrl);
+        installCursorTemplates(cwd, apiUrl, opts.user);
         hasIdeDir = true;
     }
     if (detectedIdes.includes('antigravity')) {
-        installAntigravityTemplates(cwd, apiUrl);
+        installAntigravityTemplates(cwd, apiUrl, opts.user);
         hasIdeDir = true;
     }
     if (detectedIdes.includes('kiro')) {
-        installKiroTemplates(cwd, apiUrl);
+        installKiroTemplates(cwd, apiUrl, opts.user);
         hasIdeDir = true;
     }
     // Fallback behavior: if no specific IDE config directories found
@@ -188,7 +182,7 @@ async function initProject(opts) {
     const registered = autoRegisterMcp(apiUrl, opts.user, detectedIdes.includes('antigravity'));
     // 如果没有检测到任何 AI CLI，并且也没有检测到配置文件夹，创建 .mcp.json 作为备用
     if (!registered && !hasIdeDir) {
-        createMcpJson(cwd, apiUrl);
+        createMcpJson(cwd, apiUrl, opts.user);
     }
     // --from: 从模板项目拉取 IDE 配置文件
     if (opts.from) {
@@ -282,61 +276,46 @@ function execSilent(cmd) {
     }
     catch { /* ignore */ }
 }
-/** 自动检测 AI CLI 并注册 MCP */
+/** 自动检测 AI CLI 并注册 MCP (注入环境变量实现启动即就绪) */
 function autoRegisterMcp(apiUrl, user, skipGemini = false) {
     const detected = [];
     const serverName = 'ppdocs-kg';
-    // 检测 Claude CLI (不传环境变量，MCP启动时读取.ppdocs)
+    const envFlags = `-e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user}`;
+    // Claude CLI
     if (commandExists('claude')) {
         detected.push('Claude');
         try {
             console.log(`✅ Detected Claude CLI, registering MCP...`);
-            // 先检查是否已存在
-            const checkResult = execSync(`claude mcp list`, { encoding: 'utf-8' });
-            if (checkResult.includes(serverName)) {
-                console.log(`✅ Claude MCP already configured`);
-            }
-            else {
-                const cmd = `claude mcp add ${serverName} -- npx -y @ppdocs/mcp@latest`;
-                execSync(cmd, { stdio: 'inherit' });
-            }
+            // 先移除旧配置(可能无 env)，再重新注册
+            execSilent(`claude mcp remove ${serverName}`);
+            execSync(`claude mcp add ${serverName} ${envFlags} -- npx -y @ppdocs/mcp@latest`, { stdio: 'inherit' });
         }
-        catch (e) {
-            // 如果 list 失败，尝试添加
-            try {
-                execSilent(`claude mcp remove ${serverName}`);
-                const cmd = `claude mcp add ${serverName} -- npx -y @ppdocs/mcp@latest`;
-                execSync(cmd, { stdio: 'inherit' });
-            }
-            catch {
-                console.log(`⚠️  Claude MCP registration failed`);
-            }
+        catch {
+            console.log(`⚠️  Claude MCP registration failed`);
         }
     }
-    // 检测 Codex CLI (OpenAI)
+    // Codex CLI (OpenAI)
     if (commandExists('codex')) {
         detected.push('Codex');
         try {
             console.log(`✅ Detected Codex CLI, registering MCP...`);
             execSilent(`codex mcp remove ${serverName}`);
-            const cmd = `codex mcp add ${serverName} -- npx -y @ppdocs/mcp@latest`;
-            execSync(cmd, { stdio: 'inherit' });
+            execSync(`codex mcp add ${serverName} ${envFlags} -- npx -y @ppdocs/mcp@latest`, { stdio: 'inherit' });
         }
-        catch (e) {
-            console.log(`⚠️  Codex MCP registration failed: ${e}`);
+        catch {
+            console.log(`⚠️  Codex MCP registration failed`);
         }
     }
-    // 检测 Gemini CLI
+    // Gemini CLI
     if (commandExists('gemini') && !skipGemini) {
         detected.push('Gemini');
         try {
             console.log(`✅ Detected Gemini CLI, registering MCP...`);
             execSilent(`gemini mcp remove ${serverName}`);
-            const cmd = `gemini mcp add ${serverName} "npx -y @ppdocs/mcp@latest"`;
-            execSync(cmd, { stdio: 'inherit' });
+            execSync(`gemini mcp add ${serverName} "npx -y @ppdocs/mcp@latest"`, { stdio: 'inherit' });
         }
-        catch (e) {
-            console.log(`⚠️  Gemini MCP registration failed: ${e}`);
+        catch {
+            console.log(`⚠️  Gemini MCP registration failed`);
         }
     }
     if (detected.length === 0) {
@@ -346,34 +325,33 @@ function autoRegisterMcp(apiUrl, user, skipGemini = false) {
     console.log(`✅ Registered MCP for: ${detected.join(', ')}`);
     return true;
 }
-/** 在指定路径创建或更新 mcp.json 配置 (不传 PPDOCS_API_URL，依赖 cwd/.ppdocs 文件) */
-function createMcpConfigAt(mcpPath, _apiUrl, _options) {
+/** 在指定路径创建或更新 mcp.json 配置，注入 PPDOCS_API_URL 环境变量实现启动即就绪 */
+function createMcpConfigAt(mcpPath, apiUrl, options) {
     let mcpConfig = {};
     if (fs.existsSync(mcpPath)) {
         try {
             mcpConfig = JSON.parse(fs.readFileSync(mcpPath, 'utf-8'));
         }
         catch {
-            // 解析失败时中止，避免清空已有配置
             console.log(`⚠️  ${mcpPath} JSON格式无效，跳过MCP配置写入（请手动修复后重试）`);
             return;
         }
     }
-    // Windows 需要 cmd /c 包装才能执行 npx
     const isWindows = process.platform === 'win32';
-    // 对于 Mac/Linux，IDE 可能没有用户的完整 PATH，导致找不到 npx
     const macExtraPaths = '/usr/local/bin:/opt/homebrew/bin:/home/linuxbrew/.linuxbrew/bin';
     const actualPath = `${process.env.PATH || '/usr/bin:/bin'}:${macExtraPaths}`;
+    // 构建 env: 非 Windows 补 PATH + 注入项目绑定变量
+    const env = {};
+    if (!isWindows)
+        env.PATH = actualPath;
+    if (!options?.noEnv) {
+        env.PPDOCS_API_URL = apiUrl;
+        if (options?.user)
+            env.PPDOCS_USER = options.user;
+    }
     const ppdocsServer = isWindows
-        ? {
-            command: 'cmd',
-            args: ['/c', 'npx', '-y', '@ppdocs/mcp@latest'],
-        }
-        : {
-            command: 'npx',
-            args: ['-y', '@ppdocs/mcp@latest'],
-            env: { "PATH": actualPath }
-        };
+        ? { command: 'cmd', args: ['/c', 'npx', '-y', '@ppdocs/mcp@latest'], ...(Object.keys(env).length > 0 && { env }) }
+        : { command: 'npx', args: ['-y', '@ppdocs/mcp@latest'], env };
     mcpConfig.mcpServers = {
         ...(mcpConfig.mcpServers || {}),
         "ppdocs-kg": ppdocsServer,
@@ -387,8 +365,8 @@ function createMcpConfigAt(mcpPath, _apiUrl, _options) {
     console.log(`✅ Configured MCP in ${mcpPath}`);
 }
 /** 创建 .mcp.json (手动配置备用) */
-function createMcpJson(cwd, apiUrl) {
-    createMcpConfigAt(path.join(cwd, '.mcp.json'), apiUrl);
+function createMcpJson(cwd, apiUrl, user) {
+    createMcpConfigAt(path.join(cwd, '.mcp.json'), apiUrl, { user });
 }
 /** 递归复制目录 */
 function copyDirRecursive(src, dest) {
@@ -511,9 +489,8 @@ function generateAgentsMd(cwd) {
     }
 }
 /** 安装 Cursor 模板 */
-function installCursorTemplates(cwd, apiUrl) {
-    // 1. 生成 Cursor MCP 配置
-    createMcpConfigAt(path.join(cwd, '.cursor', 'mcp.json'), apiUrl);
+function installCursorTemplates(cwd, apiUrl, user) {
+    createMcpConfigAt(path.join(cwd, '.cursor', 'mcp.json'), apiUrl, { user });
     // 2. 生成 .cursorrules 提示词
     const srcRules = path.join(TEMPLATES_DIR, 'cursorrules.md');
     const destRules = path.join(cwd, '.cursorrules');
@@ -523,9 +500,9 @@ function installCursorTemplates(cwd, apiUrl) {
     }
 }
 /** 安装 Antigravity (Gemini IDE) 模板 */
-function installAntigravityTemplates(cwd, apiUrl) {
-    // 1. 填充 .gemini/settings.json (noEnv: 依赖 .ppdocs 文件，不传 PPDOCS_API_URL 避免覆盖)
-    createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'), apiUrl, { noEnv: true });
+function installAntigravityTemplates(cwd, apiUrl, user) {
+    // Antigravity 由 gemini CLI 注册 env，文件配置不注入避免冲突
+    createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'), apiUrl, { noEnv: true, user });
     // 2. 生成 AGENTS.md
     generateAgentsMd(cwd);
     // 3. 安装斜杠命令 → 全局目录 ~/.gemini/antigravity/global_workflows/
@@ -581,9 +558,8 @@ function installAntigravityTemplates(cwd, apiUrl) {
     }
 }
 /** 安装 Kiro 模板 */
-function installKiroTemplates(cwd, apiUrl) {
-    // 1. 生成 Kiro MCP 配置
-    createMcpConfigAt(path.join(cwd, '.kiro', 'settings', 'mcp.json'), apiUrl);
+function installKiroTemplates(cwd, apiUrl, user) {
+    createMcpConfigAt(path.join(cwd, '.kiro', 'settings', 'mcp.json'), apiUrl, { user });
     // 2. 生成 Kiro Agent 规则
     const kiroRulesDir = path.join(cwd, '.kiro', 'rules');
     if (!fs.existsSync(kiroRulesDir)) {
@@ -610,21 +586,20 @@ function detectIDEs(cwd) {
     return ides;
 }
 /** 安装项目模板文件 (供授权后自动配置调用) */
-export function setupProjectFiles(cwd, apiUrl) {
+export function setupProjectFiles(cwd, apiUrl, user) {
     const detectedIdes = detectIDEs(cwd);
     if (detectedIdes.includes('antigravity')) {
-        installAntigravityTemplates(cwd, apiUrl);
+        installAntigravityTemplates(cwd, apiUrl, user);
     }
     if (detectedIdes.includes('cursor')) {
-        installCursorTemplates(cwd, apiUrl);
+        installCursorTemplates(cwd, apiUrl, user);
     }
     if (detectedIdes.includes('kiro')) {
-        installKiroTemplates(cwd, apiUrl);
+        installKiroTemplates(cwd, apiUrl, user);
     }
     if (detectedIdes.includes('claude')) {
         installClaudeTemplates(cwd);
     }
-    // 如果没检测到任何 IDE，默认安装 Claude 模板
     if (detectedIdes.length === 0) {
         installClaudeTemplates(cwd);
     }

package/dist/config.js

@@ -38,7 +38,7 @@ export async function loadConfig() {
     const envConfig = readEnvConfig();
     if (envConfig)
         return envConfig;
-    // 2. .ppdocs 文件 (由 Agent WebUI 绑定时自动生成)
+    // 2. .ppdocs 文件 (由 init 命令生成)
     const fileConfig = readPpdocsFile();
     if (fileConfig)
         return fileConfig;

package/dist/index.js

@@ -22,17 +22,9 @@ const VERSION = pkg.version;
 // 检查是否为 CLI 命令
 const args = process.argv.slice(2);
 if (args.length > 0) {
-    const result = await runCli(args);
-    if (result === 'exit')
+    const handled = await runCli(args);
+    if (handled)
         process.exit(0);
-    if (result === 'keep-alive') {
-        // webui 长驻模式，不继续执行 MCP Server
-        // 用 setInterval 保活，避免 Node.js 'unsettled top-level await' 警告
-        setInterval(() => { }, 1 << 30);
-        // @ts-ignore: 防止后续 main() 执行
-        await new Promise(() => { });
-    }
-    // result === false → 继续作为 MCP Server
 }
 // 运行 MCP 服务
 async function main() {

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "@ppdocs/mcp",
-  "version": "3.2.16",
+  "version": "3.2.18",
   "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"
+    "ppdocs-mcp": "dist/index.js"
   },
   "scripts": {
     "prebuild": "node scripts/copy-templates.js",