@ppdocs/mcp 2.5.1 → 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)) {
@@ -105,28 +185,17 @@ function initProject(opts) {
             // ignore parse error
         }
     }
+    // Windows 需要 cmd /c 包装才能执行 npx
+    const isWindows = process.platform === 'win32';
+    const ppdocsServer = isWindows
+        ? { command: 'cmd', args: ['/c', 'npx', '@ppdocs/mcp'] }
+        : { command: 'npx', args: ['@ppdocs/mcp'] };
     mcpConfig.mcpServers = {
         ...(mcpConfig.mcpServers || {}),
-        ppdocs: {
-            command: 'npx',
-            args: ['@ppdocs/mcp'],
-        },
+        ppdocs: ppdocsServer,
     };
     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) {
@@ -144,6 +213,23 @@ function copyDirRecursive(src, dest) {
         }
     }
 }
+/** 生成跨平台的 hooks 配置 */
+function generateHooksConfig() {
+    const isWindows = process.platform === 'win32';
+    const command = isWindows
+        ? 'type ".claude\\hooks\\SystemPrompt.md"'
+        : 'cat ".claude/hooks/SystemPrompt.md"';
+    return {
+        hooks: {
+            UserPromptSubmit: [
+                {
+                    matcher: '*',
+                    hooks: [{ type: 'command', command }]
+                }
+            ]
+        }
+    };
+}
 /** 安装 Claude Code 模板 */
 function installClaudeTemplates(cwd) {
     const claudeDir = path.join(cwd, '.claude');
@@ -161,26 +247,23 @@ function installClaudeTemplates(cwd) {
         copyDirRecursive(srcHooks, destHooks);
         console.log(`✅ Installed .claude/hooks/`);
     }
-    // 3. 合并 settings.local.json hooks 配置
-    const settingsHooksPath = path.join(TEMPLATES_DIR, 'settings-hooks.json');
+    // 3. 生成跨平台 hooks 配置并合并到 settings.local.json
     const settingsLocalPath = path.join(claudeDir, 'settings.local.json');
-    if (fs.existsSync(settingsHooksPath)) {
-        let existingSettings = {};
-        if (fs.existsSync(settingsLocalPath)) {
-            try {
-                existingSettings = JSON.parse(fs.readFileSync(settingsLocalPath, 'utf-8'));
-            }
-            catch { /* ignore */ }
-        }
-        const hooksConfig = JSON.parse(fs.readFileSync(settingsHooksPath, 'utf-8'));
-        const mergedSettings = {
-            ...existingSettings,
-            hooks: hooksConfig.hooks
-        };
-        fs.mkdirSync(claudeDir, { recursive: true });
-        fs.writeFileSync(settingsLocalPath, JSON.stringify(mergedSettings, null, 2));
-        console.log(`✅ Configured .claude/settings.local.json hooks`);
+    let existingSettings = {};
+    if (fs.existsSync(settingsLocalPath)) {
+        try {
+            existingSettings = JSON.parse(fs.readFileSync(settingsLocalPath, 'utf-8'));
+        }
+        catch { /* ignore */ }
     }
+    const hooksConfig = generateHooksConfig();
+    const mergedSettings = {
+        ...existingSettings,
+        ...hooksConfig
+    };
+    fs.mkdirSync(claudeDir, { recursive: true });
+    fs.writeFileSync(settingsLocalPath, JSON.stringify(mergedSettings, null, 2));
+    console.log(`✅ Configured .claude/settings.local.json hooks (${process.platform})`);
 }
 /** 安装 Codex 模板 (生成 AGENTS.md) */
 function installCodexTemplates(cwd) {

package/package.json

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

package/templates/settings-hooks.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"console.log(require('fs').readFileSync('.claude/hooks/SystemPrompt.md','utf8'))\""
+            "command": "type \".claude\\hooks\\SystemPrompt.md\""
           }
         ]
       }