@ppdocs/mcp 3.2.18 → 3.2.19

package/dist/cli.js

@@ -89,10 +89,12 @@ function showHelp() {
 ppdocs MCP CLI
 
 Commands:
-  init    Initialize ppdocs config + install workflow templates
+  init    Full setup: .ppdocs + templates + MCP registration
+  bind    Lightweight: only create .ppdocs (for adding projects to existing MCP)
 
 Usage:
   npx @ppdocs/mcp init -p <projectId> -k <key> [options]
+  npx @ppdocs/mcp bind -p <projectId> -k <key> [options]
 
 Options:
   -p, --project  Project ID (required)
@@ -105,51 +107,55 @@ Options:
   --sync <id>    Sync knowledge base docs from a source project to ./docs/ppdocs/
 
 Example:
-  npx @ppdocs/mcp init -p myproject -k abc123xyz
-  npx @ppdocs/mcp init -p myproject -k abc123xyz --codex
-  npx @ppdocs/mcp init -p myproject -k abc123xyz --from _templates
-  npx @ppdocs/mcp init -p myproject -k abc123xyz --sync shared-rules
+  npx @ppdocs/mcp init -p myproject -k abc123xyz --api 192.168.1.100
+  npx @ppdocs/mcp bind -p myproject -k abc123xyz --api 192.168.1.100
 `);
 }
 export async function runCli(args) {
     const cmd = args[0];
-    if (cmd === 'init') {
+    if (cmd === 'init' || cmd === 'bind') {
         const opts = parseArgs(args.slice(1));
         if (!opts) {
             console.error('Error: -p (project) and -k (key) are required\n');
             showHelp();
             process.exit(1);
         }
-        await initProject(opts);
+        if (cmd === 'bind') {
+            bindProject(opts);
+        }
+        else {
+            await initProject(opts);
+        }
         return true;
     }
     if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
         showHelp();
         return true;
     }
-    return false; // Not a CLI command, run as MCP server
+    return false;
 }
-async function initProject(opts) {
-    const cwd = process.cwd();
+/** 轻量绑定: 仅创建 .ppdocs, 不注册 MCP 不安装模板 */
+function bindProject(opts) {
+    writePpdocsConfig(process.cwd(), opts);
+    console.log(`\n🔗 Project bound: ${opts.project}\n   AI will auto-connect via kg_init when opening this directory.\n`);
+}
+/** 写入 .ppdocs 配置文件 (init + bind 复用) */
+function writePpdocsConfig(cwd, opts) {
     const apiUrl = `http://${opts.api}:${opts.port}/api/${opts.project}/${opts.key}`;
-    // Create .ppdocs config
-    const ppdocsConfig = {
-        api: `http://${opts.api}:${opts.port}`,
-        projectId: opts.project,
-        key: opts.key,
-        user: opts.user,
-    };
     const ppdocsPath = path.join(cwd, '.ppdocs');
-    // 检查是否存在同名目录，如果是则删除
-    if (fs.existsSync(ppdocsPath)) {
-        const stat = fs.statSync(ppdocsPath);
-        if (stat.isDirectory()) {
-            fs.rmSync(ppdocsPath, { recursive: true });
-            console.log(`⚠️  Removed existing .ppdocs directory`);
-        }
+    if (fs.existsSync(ppdocsPath) && fs.statSync(ppdocsPath).isDirectory()) {
+        fs.rmSync(ppdocsPath, { recursive: true });
+        console.log(`⚠️  Removed existing .ppdocs directory`);
     }
-    fs.writeFileSync(ppdocsPath, JSON.stringify(ppdocsConfig, null, 2));
+    fs.writeFileSync(ppdocsPath, JSON.stringify({
+        api: `http://${opts.api}:${opts.port}`, projectId: opts.project, key: opts.key, user: opts.user,
+    }, null, 2));
     console.log(`✅ Created ${ppdocsPath}`);
+    return apiUrl;
+}
+async function initProject(opts) {
+    const cwd = process.cwd();
+    const apiUrl = writePpdocsConfig(cwd, opts);
     // Install workflow templates based on IDE detection
     const detectedIdes = detectIDEs(cwd);
     let hasIdeDir = false;
@@ -179,7 +185,7 @@ async function initProject(opts) {
         }
     }
     // 自动检测并注册 MCP (如果已写入 Antigravity 配置，跳过 gemini CLI 注册避免冲突)
-    const registered = autoRegisterMcp(apiUrl, opts.user, detectedIdes.includes('antigravity'));
+    const registered = autoRegisterMcp(detectedIdes.includes('antigravity'));
     // 如果没有检测到任何 AI CLI，并且也没有检测到配置文件夹，创建 .mcp.json 作为备用
     if (!registered && !hasIdeDir) {
         createMcpJson(cwd, apiUrl, opts.user);
@@ -276,31 +282,39 @@ function execSilent(cmd) {
     }
     catch { /* ignore */ }
 }
-/** 自动检测 AI CLI 并注册 MCP (注入环境变量实现启动即就绪) */
-function autoRegisterMcp(apiUrl, user, skipGemini = false) {
+/** 自动检测 AI CLI 并注册全局 MCP (不注入 env，支持多项目通过 kg_init 切换) */
+function autoRegisterMcp(skipGemini = false) {
     const detected = [];
     const serverName = 'ppdocs-kg';
-    const envFlags = `-e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user}`;
-    // Claude CLI
+    const addCmd = `-- npx -y @ppdocs/mcp@latest`;
+    // Claude CLI (幂等：已注册则跳过)
     if (commandExists('claude')) {
         detected.push('Claude');
         try {
-            console.log(`✅ Detected Claude CLI, registering MCP...`);
-            // 先移除旧配置(可能无 env)，再重新注册
-            execSilent(`claude mcp remove ${serverName}`);
-            execSync(`claude mcp add ${serverName} ${envFlags} -- npx -y @ppdocs/mcp@latest`, { stdio: 'inherit' });
+            const list = execSync(`claude mcp list`, { encoding: 'utf-8' });
+            if (list.includes(serverName)) {
+                console.log(`✅ Claude MCP already configured`);
+            }
+            else {
+                execSync(`claude mcp add ${serverName} ${addCmd}`, { stdio: 'inherit' });
+            }
         }
         catch {
-            console.log(`⚠️  Claude MCP registration failed`);
+            try {
+                execSilent(`claude mcp remove ${serverName}`);
+                execSync(`claude mcp add ${serverName} ${addCmd}`, { stdio: 'inherit' });
+            }
+            catch {
+                console.log(`⚠️  Claude MCP registration failed`);
+            }
         }
     }
-    // Codex CLI (OpenAI)
+    // Codex CLI
     if (commandExists('codex')) {
         detected.push('Codex');
         try {
-            console.log(`✅ Detected Codex CLI, registering MCP...`);
             execSilent(`codex mcp remove ${serverName}`);
-            execSync(`codex mcp add ${serverName} ${envFlags} -- npx -y @ppdocs/mcp@latest`, { stdio: 'inherit' });
+            execSync(`codex mcp add ${serverName} ${addCmd}`, { stdio: 'inherit' });
         }
         catch {
             console.log(`⚠️  Codex MCP registration failed`);
@@ -310,7 +324,6 @@ function autoRegisterMcp(apiUrl, user, skipGemini = false) {
     if (commandExists('gemini') && !skipGemini) {
         detected.push('Gemini');
         try {
-            console.log(`✅ Detected Gemini CLI, registering MCP...`);
             execSilent(`gemini mcp remove ${serverName}`);
             execSync(`gemini mcp add ${serverName} "npx -y @ppdocs/mcp@latest"`, { stdio: 'inherit' });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ppdocs/mcp",
-  "version": "3.2.18",
+  "version": "3.2.19",
   "description": "ppdocs MCP Server - Knowledge Graph for Claude",
   "type": "module",
   "main": "dist/index.js",