@ppdocs/mcp 3.2.2 → 3.2.4

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -112,7 +112,7 @@ Example:
   npx @ppdocs/mcp init -p myproject -k abc123xyz --sync shared-rules
 `);
 }
-export function runCli(args) {
+export async function runCli(args) {
     const cmd = args[0];
     if (cmd === 'init') {
         const opts = parseArgs(args.slice(1));
@@ -121,23 +121,17 @@ export function runCli(args) {
             showHelp();
             process.exit(1);
         }
-        initProject(opts).catch(e => {
-            console.error(`❌ Init failed: ${e}`);
-            process.exit(1);
-        });
-        return true;
+        await initProject(opts);
+        return 'exit';
     }
     if (cmd === 'agent' || cmd === 'webui') {
-        // 动态导入 Agent 入口 (Web UI + 多项目管理)
-        import('./agent.js').catch(e => {
-            console.error(`❌ Agent failed: ${e}`);
-            process.exit(1);
-        });
-        return true;
+        // 动态导入 Agent 入口 (Web UI + 多项目管理) — 长驻进程，不退出
+        await import('./agent.js');
+        return 'keep-alive';
     }
     if (cmd === '--help' || cmd === '-h' || cmd === 'help') {
         showHelp();
-        return true;
+        return 'exit';
     }
     return false; // Not a CLI command, run as MCP server
 }

package/dist/config.d.ts

@@ -1,22 +1,14 @@
 /**
  * ppdocs MCP Config
- * 读取配置: 环境变量 > .ppdocs 文件 > 自动发现 > 授权请求
+ * 读取配置: 环境变量 > .ppdocs 文件 > 提示去 Agent WebUI 绑定
  */
 export interface PpdocsConfig {
     apiUrl: string;
     projectId: string;
     user: string;
-    source: 'env' | 'file' | 'auth';
-    /** 原始连接参数 (discover/auth 填充, 供持久化使用) */
-    connection?: {
-        host: string;
-        port: number;
-        password: string;
-    };
+    source: 'env' | 'file';
 }
 export declare const PPDOCS_CONFIG_FILE = ".ppdocs";
 /** 生成随机用户名 */
 export declare function generateUser(): string;
-/** 写入 .ppdocs 文件 (需 config.connection 存在) */
-export declare function writePpdocsFile(config: PpdocsConfig): void;
 export declare function loadConfig(): Promise<PpdocsConfig>;

package/dist/config.js

@@ -1,17 +1,16 @@
 /**
  * ppdocs MCP Config
- * 读取配置: 环境变量 > .ppdocs 文件 > 自动发现 > 授权请求
+ * 读取配置: 环境变量 > .ppdocs 文件 > 提示去 Agent WebUI 绑定
  */
 import * as fs from 'fs';
 import * as path from 'path';
-import * as os from 'os';
 export const PPDOCS_CONFIG_FILE = '.ppdocs';
 /** 生成随机用户名 */
 export function generateUser() {
     const chars = 'abcdefghjkmnpqrstuvwxyz23456789';
     return Array.from({ length: 8 }, () => chars[Math.floor(Math.random() * chars.length)]).join('');
 }
-// ============ 静态配置读取 ============
+// ============ 配置读取 ============
 function readEnvConfig() {
     const apiUrl = process.env.PPDOCS_API_URL;
     if (!apiUrl)
@@ -33,104 +32,24 @@ function readPpdocsFile() {
         return null;
     }
 }
-async function findLocalServer() {
-    for (const host of ['localhost', '127.0.0.1', '10.0.0.176']) {
-        for (const port of [20001]) {
-            try {
-                const res = await fetch(`http://${host}:${port}/health`, { signal: AbortSignal.timeout(2000) });
-                if (res.ok)
-                    return { host, port, base: `http://${host}:${port}` };
-            }
-            catch {
-                continue;
-            }
-        }
-    }
-    return null;
-}
-// ============ 授权请求 ============
-async function requestAuthConfig(server) {
-    try {
-        const reqRes = await fetch(`${server.base}/api/auth/request`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ cwd: process.cwd(), hostname: os.hostname() }),
-        });
-        if (!reqRes.ok)
-            return null;
-        const { data } = await reqRes.json();
-        if (!data?.requestId)
-            return null;
-        console.error(`[Auth] 等待桌面端授权... (请在 ppdocs 桌面端确认)`);
-        for (let i = 0; i < 150; i++) {
-            await new Promise(r => setTimeout(r, 2000));
-            const pollRes = await fetch(`${server.base}/api/auth/poll/${data.requestId}`, { signal: AbortSignal.timeout(3000) });
-            if (!pollRes.ok)
-                continue;
-            const { data: poll } = await pollRes.json();
-            if (poll?.status === 'approved' && poll.result) {
-                const r = poll.result;
-                console.error(`[Auth] 已授权: ${r.project_name} (${r.project_id})`);
-                return {
-                    apiUrl: `http://${r.api_host}:${r.api_port}/api/${r.project_id}/${r.password}`,
-                    projectId: r.project_id,
-                    user: `auto-${generateUser().slice(0, 4)}`,
-                    source: 'auth',
-                    connection: { host: r.api_host, port: r.api_port, password: r.password },
-                };
-            }
-            if (poll?.status === 'rejected') {
-                console.error('[Auth] 授权被拒绝');
-                return null;
-            }
-            if (poll?.status === 'expired') {
-                console.error('[Auth] 授权超时');
-                return null;
-            }
-        }
-        console.error('[Auth] 轮询超时');
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-// ============ 持久化 ============
-/** 写入 .ppdocs 文件 (需 config.connection 存在) */
-export function writePpdocsFile(config) {
-    if (!config.connection)
-        return;
-    const configPath = path.join(process.cwd(), '.ppdocs');
-    if (fs.existsSync(configPath))
-        return;
-    const { host, port, password } = config.connection;
-    fs.writeFileSync(configPath, JSON.stringify({
-        api: `http://${host}:${port}`,
-        projectId: config.projectId,
-        key: password,
-        user: config.user,
-    }, null, 2), 'utf-8');
-    console.error(`[Config] 已保存 .ppdocs`);
-}
 // ============ 入口 ============
 export async function loadConfig() {
     // 1. 环境变量
     const envConfig = readEnvConfig();
     if (envConfig)
         return envConfig;
-    // 2. .ppdocs 文件
+    // 2. .ppdocs 文件 (由 Agent WebUI 绑定时自动生成)
     const fileConfig = readPpdocsFile();
     if (fileConfig)
         return fileConfig;
-    // 3. 扫描本地服务器 → 请求桌面端授权
-    const server = await findLocalServer();
-    if (server) {
-        const authConfig = await requestAuthConfig(server);
-        if (authConfig)
-            return authConfig;
-    }
-    // 全部失败
-    console.error('ERROR: ppdocs 配置未找到');
-    console.error('  请确保 ppdocs 桌面端正在运行，或手动配置 PPDOCS_API_URL 环境变量');
+    // 无配置 → 提示用户去 Agent WebUI 绑定
+    console.error('ERROR: 未找到 .ppdocs 配置');
+    console.error('');
+    console.error('  请在 Agent WebUI 绑定此项目:');
+    console.error('  1. 启动 Agent:  npx @ppdocs/mcp webui');
+    console.error('  2. 打开浏览器:  http://localhost:20010');
+    console.error('  3. 添加项目 → 选择本地目录和远程知识库 → 自动生成 .ppdocs');
+    console.error('');
+    console.error('  或手动设置环境变量: PPDOCS_API_URL=http://host:port/api/projectId/key');
     process.exit(1);
 }

package/dist/index.js

@@ -13,30 +13,28 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { registerTools } from './tools/index.js';
 import { initClient } from './storage/httpClient.js';
-import { runCli, setupProjectFiles } from './cli.js';
-import { loadConfig, writePpdocsFile } from './config.js';
+import { runCli } from './cli.js';
+import { loadConfig } from './config.js';
 // 从 package.json 读取版本号
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8'));
 const VERSION = pkg.version;
 // 检查是否为 CLI 命令
 const args = process.argv.slice(2);
-if (args.length > 0 && runCli(args)) {
-    process.exit(0);
+if (args.length > 0) {
+    const result = await runCli(args);
+    if (result === 'exit')
+        process.exit(0);
+    if (result === 'keep-alive') {
+        // agent/webui 长驻模式，不继续执行 MCP Server
+        // @ts-ignore: 阻止后续 main() 执行
+        await new Promise(() => { }); // 永不 resolve，进程由 agent.ts 的 HTTP 服务保活
+    }
+    // result === false → 继续作为 MCP Server
 }
 // 运行 MCP 服务
 async function main() {
     const config = await loadConfig();
-    // 自动持久化: 发现/授权后写入 .ppdocs + 安装模板
-    if (config.source === 'auth' && config.connection) {
-        try {
-            writePpdocsFile(config);
-            setupProjectFiles(process.cwd(), config.apiUrl);
-        }
-        catch (e) {
-            console.error('[AutoSetup] 自动配置失败:', e);
-        }
-    }
     initClient(config.apiUrl);
     const server = new McpServer({ name: `ppdocs [${config.projectId}]`, version: VERSION }, { capabilities: { tools: {} } });
     registerTools(server, config.projectId, config.user);

package/dist/web/server.js

@@ -39,6 +39,25 @@ export function saveAgentConfig(config) {
     fs.mkdirSync(CONFIG_DIR, { recursive: true });
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
 }
+/** 写入 .ppdocs 到项目目录，供 MCP 直接读取 */
+function writePpdocsToProject(binding, host, port) {
+    if (!binding.localDir || !binding.remote.password)
+        return;
+    const configPath = path.join(binding.localDir, '.ppdocs');
+    const content = {
+        api: `http://${host}:${port}`,
+        projectId: binding.remote.id,
+        key: binding.remote.password,
+        user: `agent-${binding.localName.slice(0, 8)}`,
+    };
+    try {
+        fs.writeFileSync(configPath, JSON.stringify(content, null, 2), 'utf-8');
+        console.log(`[Config] 已写入 ${configPath}`);
+    }
+    catch (e) {
+        console.error(`[Config] 写入 .ppdocs 失败: ${e}`);
+    }
+}
 const state = {
     hostConnected: false,
     projectStatus: new Map(),
@@ -233,6 +252,8 @@ export function startWebServer(webPort) {
         };
         config.projects.push(binding);
         saveAgentConfig(config);
+        // 写入 .ppdocs 到项目目录，供 MCP 直接读取
+        writePpdocsToProject(binding, config.host, config.port);
         // 通知 Agent 主进程启动同步
         if (state.onBind)
             state.onBind(binding);

package/package.json

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