@ppdocs/mcp 3.1.6 → 3.1.8

package/dist/cli.js

@@ -161,15 +161,15 @@ async function initProject(opts) {
         hasIdeDir = true;
     }
     if (detectedIdes.includes('cursor')) {
-        installCursorTemplates(cwd);
+        installCursorTemplates(cwd, apiUrl);
         hasIdeDir = true;
     }
     if (detectedIdes.includes('antigravity')) {
-        installAntigravityTemplates(cwd);
+        installAntigravityTemplates(cwd, apiUrl);
         hasIdeDir = true;
     }
     if (detectedIdes.includes('kiro')) {
-        installKiroTemplates(cwd);
+        installKiroTemplates(cwd, apiUrl);
         hasIdeDir = true;
     }
     // Fallback behavior: if no specific IDE config directories found
@@ -185,7 +185,7 @@ async function initProject(opts) {
     const registered = autoRegisterMcp(apiUrl, opts.user);
     // 如果没有检测到任何 AI CLI，并且也没有检测到配置文件夹，创建 .mcp.json 作为备用
     if (!registered && !hasIdeDir) {
-        createMcpJson(cwd);
+        createMcpJson(cwd, apiUrl);
     }
     // --from: 从模板项目拉取 IDE 配置文件
     if (opts.from) {
@@ -344,7 +344,7 @@ function autoRegisterMcp(apiUrl, user) {
     return true;
 }
 /** 在指定路径创建或更新 mcp.json 配置 */
-function createMcpConfigAt(mcpPath, autoCreatedTemplate) {
+function createMcpConfigAt(mcpPath, apiUrl) {
     let mcpConfig = {};
     if (fs.existsSync(mcpPath)) {
         try {
@@ -356,9 +356,22 @@ function createMcpConfigAt(mcpPath, autoCreatedTemplate) {
     }
     // Windows 需要 cmd /c 包装才能执行 npx
     const isWindows = process.platform === 'win32';
+    // 对于 Mac/Linux，IDE 可能没有用户的完整 PATH，导致找不到 npx
     const ppdocsServer = isWindows
-        ? { command: 'cmd', args: ['/c', 'npx', '-y', '@ppdocs/mcp@latest'] }
-        : { command: 'npx', args: ['-y', '@ppdocs/mcp@latest'] };
+        ? {
+            command: 'cmd',
+            args: ['/c', 'npx', '-y', '@ppdocs/mcp@latest'],
+            env: { "PPDOCS_API_URL": apiUrl }
+        }
+        : {
+            command: 'npx',
+            args: ['-y', '@ppdocs/mcp@latest'],
+            env: {
+                "PPDOCS_API_URL": apiUrl,
+                // 强行注入常见路径，防止找不到 node/npx
+                "PATH": "$PATH:/usr/local/bin:/opt/homebrew/bin:/home/linuxbrew/.linuxbrew/bin"
+            }
+        };
     mcpConfig.mcpServers = {
         ...(mcpConfig.mcpServers || {}),
         "ppdocs-kg": ppdocsServer,
@@ -372,8 +385,8 @@ function createMcpConfigAt(mcpPath, autoCreatedTemplate) {
     console.log(`✅ Configured MCP in ${mcpPath}`);
 }
 /** 创建 .mcp.json (手动配置备用) */
-function createMcpJson(cwd) {
-    createMcpConfigAt(path.join(cwd, '.mcp.json'));
+function createMcpJson(cwd, apiUrl) {
+    createMcpConfigAt(path.join(cwd, '.mcp.json'), apiUrl);
 }
 /** 递归复制目录 */
 function copyDirRecursive(src, dest) {
@@ -496,9 +509,9 @@ function generateAgentsMd(cwd) {
     }
 }
 /** 安装 Cursor 模板 */
-function installCursorTemplates(cwd) {
+function installCursorTemplates(cwd, apiUrl) {
     // 1. 生成 Cursor MCP 配置
-    createMcpConfigAt(path.join(cwd, '.cursor', 'mcp.json'));
+    createMcpConfigAt(path.join(cwd, '.cursor', 'mcp.json'), apiUrl);
     // 2. 生成 .cursorrules 提示词
     const srcRules = path.join(TEMPLATES_DIR, 'cursorrules.md');
     const destRules = path.join(cwd, '.cursorrules');
@@ -508,9 +521,9 @@ function installCursorTemplates(cwd) {
     }
 }
 /** 安装 Antigravity (Gemini IDE) 模板 */
-function installAntigravityTemplates(cwd) {
+function installAntigravityTemplates(cwd, apiUrl) {
     // 1. 填充 .gemini/settings.json
-    createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'));
+    createMcpConfigAt(path.join(cwd, '.gemini', 'settings.json'), apiUrl);
     // 2. 生成 AGENTS.md
     generateAgentsMd(cwd);
     // 3. 安装斜杠命令 → .agents/workflows/ (Antigravity 的 slash command 机制)
@@ -546,9 +559,9 @@ function installAntigravityTemplates(cwd) {
     }
 }
 /** 安装 Kiro 模板 */
-function installKiroTemplates(cwd) {
+function installKiroTemplates(cwd, apiUrl) {
     // 1. 生成 Kiro MCP 配置
-    createMcpConfigAt(path.join(cwd, '.kiro', 'settings', 'mcp.json'));
+    createMcpConfigAt(path.join(cwd, '.kiro', 'settings', 'mcp.json'), apiUrl);
     // 2. 生成 Kiro Agent 规则
     const kiroRulesDir = path.join(cwd, '.kiro', 'rules');
     if (!fs.existsSync(kiroRulesDir)) {

package/package.json

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