@ppdocs/mcp 3.2.3 → 3.2.5

package/dist/cli.js

@@ -346,8 +346,8 @@ function autoRegisterMcp(apiUrl, user, skipGemini = false) {
     console.log(`✅ Registered MCP for: ${detected.join(', ')}`);
     return true;
 }
-/** 在指定路径创建或更新 mcp.json 配置 */
-function createMcpConfigAt(mcpPath, apiUrl, options) {
+/** 在指定路径创建或更新 mcp.json 配置 (不传 PPDOCS_API_URL，依赖 cwd/.ppdocs 文件) */
+function createMcpConfigAt(mcpPath, _apiUrl, _options) {
     let mcpConfig = {};
     if (fs.existsSync(mcpPath)) {
         try {
@@ -362,24 +362,17 @@ function createMcpConfigAt(mcpPath, apiUrl, options) {
     // Windows 需要 cmd /c 包装才能执行 npx
     const isWindows = process.platform === 'win32';
     // 对于 Mac/Linux，IDE 可能没有用户的完整 PATH，导致找不到 npx
-    // 使用实际 PATH 值拼接，JSON 中的 $PATH 不会被展开
     const macExtraPaths = '/usr/local/bin:/opt/homebrew/bin:/home/linuxbrew/.linuxbrew/bin';
     const actualPath = `${process.env.PATH || '/usr/bin:/bin'}:${macExtraPaths}`;
     const ppdocsServer = isWindows
         ? {
             command: 'cmd',
             args: ['/c', 'npx', '-y', '@ppdocs/mcp@latest'],
-            ...(options?.noEnv ? {} : { env: { "PPDOCS_API_URL": apiUrl } })
         }
         : {
             command: 'npx',
             args: ['-y', '@ppdocs/mcp@latest'],
-            ...(options?.noEnv ? { env: { "PATH": actualPath } } : {
-                env: {
-                    "PPDOCS_API_URL": apiUrl,
-                    "PATH": actualPath
-                }
-            })
+            env: { "PATH": actualPath }
         };
     mcpConfig.mcpServers = {
         ...(mcpConfig.mcpServers || {}),

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,8 +13,8 @@ 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'));
@@ -35,16 +35,6 @@ if (args.length > 0) {
 // 运行 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(),
@@ -57,8 +76,11 @@ export function setProjectStatus(remoteId, status) {
 export function startWebServer(webPort) {
     const app = express();
     app.use(express.json());
-    // GET / → UI
+    app.disable('etag'); // 禁用 ETag，避免 304 缓存导致前端数据不更新
+    // GET / → UI (禁止浏览器缓存，确保加载最新版本)
     app.get('/', (_req, res) => {
+        res.set('Cache-Control', 'no-store, no-cache, must-revalidate');
+        res.set('Pragma', 'no-cache');
         res.type('html').send(getAgentHtml());
     });
     // GET /api/status → 全局+各项目状态
@@ -140,10 +162,7 @@ export function startWebServer(webPort) {
     // POST /api/auth/start → 发起授权请求 (代理转发到主机)
     app.post('/api/auth/start', async (req, res) => {
         const { localDir } = req.body;
-        if (!localDir) {
-            res.json({ ok: false, error: '缺少本地目录' });
-            return;
-        }
+        // localDir 可选，用于 APP 端显示来源信息
         const config = loadAgentConfig();
         if (!config?.host) {
             res.json({ ok: false, error: '请先配置主机' });
@@ -210,8 +229,8 @@ export function startWebServer(webPort) {
     // POST /api/bind → 绑定项目 (授权通过后调用)
     app.post('/api/bind', async (req, res) => {
         const { localDir, remoteId, remoteName, password } = req.body;
-        if (!localDir || !remoteId) {
-            res.json({ ok: false, error: '缺少参数' });
+        if (!remoteId) {
+            res.json({ ok: false, error: '缺少 remoteId' });
             return;
         }
         const config = loadAgentConfig();
@@ -225,14 +244,17 @@ export function startWebServer(webPort) {
             return;
         }
         const binding = {
-            localDir,
-            localName: path.basename(localDir),
+            localDir: localDir || '',
+            localName: localDir ? path.basename(localDir) : (remoteName || remoteId),
             remote: { id: remoteId, name: remoteName || remoteId, password: password || '' },
             sync: { enabled: true, intervalSec: 15 },
             createdAt: new Date().toISOString(),
         };
         config.projects.push(binding);
         saveAgentConfig(config);
+        // 有本地目录时才写 .ppdocs
+        if (localDir)
+            writePpdocsToProject(binding, config.host, config.port);
         // 通知 Agent 主进程启动同步
         if (state.onBind)
             state.onBind(binding);
@@ -557,17 +579,15 @@ function hasMcpInJson(filePath, serverName) {
         return false;
     }
 }
-/** 构建 MCP server 配置对象 */
-function buildMcpServerConfig(apiUrl, isWindows) {
+/** 构建 MCP server 配置对象 (不传 PPDOCS_API_URL，依赖 cwd/.ppdocs 文件自动识别项目) */
+function buildMcpServerConfig(_apiUrl, isWindows) {
     return isWindows ? {
         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,
             PATH: `${process.env.PATH || '/usr/bin:/bin'}:/usr/local/bin:/opt/homebrew/bin`,
         },
     };