@ppdocs/mcp 2.5.2 → 2.6.0

package/dist/cli.d.ts

@@ -1,5 +1,5 @@
 /**
  * ppdocs MCP CLI
- * 命令: init - 初始化项目配置 + 安装工作流模板
+ * 命令: init - 初始化项目配置 + 安装工作流模板 + 自动注册 MCP
  */
 export declare function runCli(args: string[]): boolean;

package/dist/cli.js

@@ -1,10 +1,11 @@
 /**
  * ppdocs MCP CLI
- * 命令: init - 初始化项目配置 + 安装工作流模板
+ * 命令: init - 初始化项目配置 + 安装工作流模板 + 自动注册 MCP
  */
 import * as fs from 'fs';
 import * as path from 'path';
 import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const TEMPLATES_DIR = path.join(__dirname, '..', 'templates');
 /** 生成随机用户名 (8位字母数字) */
@@ -84,6 +85,7 @@ export function runCli(args) {
 }
 function initProject(opts) {
     const cwd = process.cwd();
+    const apiUrl = `http://${opts.api}:${opts.port}/api/${opts.project}/${opts.key}`;
     // Create .ppdocs config
     const ppdocsConfig = {
         api: `http://${opts.api}:${opts.port}`,
@@ -94,7 +96,85 @@ function initProject(opts) {
     const ppdocsPath = path.join(cwd, '.ppdocs');
     fs.writeFileSync(ppdocsPath, JSON.stringify(ppdocsConfig, null, 2));
     console.log(`✅ Created ${ppdocsPath}`);
-    // Create or update .mcp.json
+    // Install workflow templates
+    if (opts.codex) {
+        installCodexTemplates(cwd);
+    }
+    else {
+        installClaudeTemplates(cwd);
+    }
+    // 自动检测并注册 MCP
+    const registered = autoRegisterMcp(apiUrl, opts.user);
+    // 如果没有检测到任何 AI CLI，创建 .mcp.json 作为备用
+    if (!registered) {
+        createMcpJson(cwd);
+    }
+    console.log(`
+🎉 Done! ppdocs MCP configured for project: ${opts.project}
+   User: ${opts.user}
+
+Restart your AI tool to use ppdocs knowledge graph.
+`);
+}
+/** 检测命令是否存在 */
+function commandExists(cmd) {
+    try {
+        const checkCmd = process.platform === 'win32' ? `where ${cmd}` : `which ${cmd}`;
+        execSync(checkCmd, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 自动检测 AI CLI 并注册 MCP */
+function autoRegisterMcp(apiUrl, user) {
+    const detected = [];
+    // 检测 Claude CLI
+    if (commandExists('claude')) {
+        detected.push('Claude');
+        try {
+            const cmd = `claude mcp add ppdocs-kg -e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user} -- npx -y @ppdocs/mcp`;
+            console.log(`✅ Detected Claude CLI, registering MCP...`);
+            execSync(cmd, { stdio: 'inherit' });
+        }
+        catch (e) {
+            console.log(`⚠️  Claude MCP registration failed: ${e}`);
+        }
+    }
+    // 检测 Codex CLI (OpenAI)
+    if (commandExists('codex')) {
+        detected.push('Codex');
+        try {
+            const cmd = `codex mcp add ppdocs-kg -e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user} -- npx -y @ppdocs/mcp`;
+            console.log(`✅ Detected Codex CLI, registering MCP...`);
+            execSync(cmd, { stdio: 'inherit' });
+        }
+        catch (e) {
+            console.log(`⚠️  Codex MCP registration failed: ${e}`);
+        }
+    }
+    // 检测 Gemini CLI
+    if (commandExists('gemini')) {
+        detected.push('Gemini');
+        try {
+            const cmd = `gemini mcp add ppdocs-kg -e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user} -- npx -y @ppdocs/mcp`;
+            console.log(`✅ Detected Gemini CLI, registering MCP...`);
+            execSync(cmd, { stdio: 'inherit' });
+        }
+        catch (e) {
+            console.log(`⚠️  Gemini MCP registration failed: ${e}`);
+        }
+    }
+    if (detected.length === 0) {
+        console.log(`ℹ️  No AI CLI detected (claude/codex/gemini), creating .mcp.json for manual config`);
+        return false;
+    }
+    console.log(`✅ Registered MCP for: ${detected.join(', ')}`);
+    return true;
+}
+/** 创建 .mcp.json (手动配置备用) */
+function createMcpJson(cwd) {
     const mcpPath = path.join(cwd, '.mcp.json');
     let mcpConfig = {};
     if (fs.existsSync(mcpPath)) {
@@ -116,19 +196,6 @@ function initProject(opts) {
     };
     fs.writeFileSync(mcpPath, JSON.stringify(mcpConfig, null, 2));
     console.log(`✅ Created ${mcpPath}`);
-    // Install workflow templates
-    if (opts.codex) {
-        installCodexTemplates(cwd);
-    }
-    else {
-        installClaudeTemplates(cwd);
-    }
-    console.log(`
-🎉 Done! ppdocs MCP configured for project: ${opts.project}
-   User: ${opts.user}
-
-Restart Claude Code to use ppdocs knowledge graph.
-`);
 }
 /** 递归复制目录 */
 function copyDirRecursive(src, dest) {

package/package.json

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