@ppdocs/mcp 3.5.0 → 3.6.0

package/dist/config.d.ts

@@ -6,6 +6,7 @@ export interface PpdocsConfig {
     apiUrl: string;
     projectId: string;
     user: string;
+    agentId: string;
     source: 'env' | 'file';
 }
 export declare const PPDOCS_CONFIG_FILE = ".ppdocs";

package/dist/config.js

@@ -16,7 +16,13 @@ function readEnvConfig() {
     if (!apiUrl)
         return null;
     const match = apiUrl.match(/\/api\/([^/]+)\/[^/]+\/?$/);
-    return { apiUrl, projectId: match?.[1] || 'unknown', user: process.env.PPDOCS_USER || generateUser(), source: 'env' };
+    return {
+        apiUrl,
+        projectId: match?.[1] || 'unknown',
+        user: process.env.PPDOCS_USER || generateUser(),
+        agentId: process.env.PPDOCS_AGENT_ID || 'default',
+        source: 'env',
+    };
 }
 function readPpdocsFile() {
     const configPath = path.join(process.cwd(), '.ppdocs');
@@ -26,7 +32,7 @@ function readPpdocsFile() {
         const c = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
         if (!c.api || !c.projectId || !c.key)
             return null;
-        return { apiUrl: `${c.api}/api/${c.projectId}/${c.key}`, projectId: c.projectId, user: c.user || generateUser(), source: 'file' };
+        return { apiUrl: `${c.api}/api/${c.projectId}/${c.key}`, projectId: c.projectId, user: c.user || generateUser(), agentId: c.agentId || process.env.PPDOCS_AGENT_ID || 'default', source: 'file' };
     }
     catch {
         return null;

package/dist/index.js

@@ -39,8 +39,9 @@ async function main() {
     }
     const projectId = config?.projectId || 'pending';
     const user = config?.user || 'agent';
+    const agentId = config?.agentId || process.env.PPDOCS_AGENT_ID || 'default';
     const server = new McpServer({ name: `ppdocs [${projectId}]`, version: VERSION }, { capabilities: { tools: {} } });
-    registerTools(server, projectId, user, (newProjectId, newApiUrl) => {
+    registerTools(server, projectId, user, agentId, (newProjectId, newApiUrl) => {
         console.error(`[kg_init] 项目已切换: ${newProjectId}`);
     });
     const transport = new StdioServerTransport();

package/dist/tools/discussion.js

@@ -15,7 +15,9 @@ import { getClient } from '../storage/httpClient.js';
 import { decodeObjectStrings } from '../utils.js';
 import { wrap, safeTool } from './shared.js';
 function sender(ctx) {
-    return `${ctx.projectId}:${ctx.user}`;
+    return ctx.agentId && ctx.agentId !== 'default'
+        ? `${ctx.projectId}:${ctx.user}:${ctx.agentId}`
+        : `${ctx.projectId}:${ctx.user}`;
 }
 /** 提取 sender 中的 projectId */
 function senderProjectId(senderStr) {

package/dist/tools/index.d.ts

@@ -12,4 +12,4 @@
  * 🏛️ 协作:    kg_meeting                                         (1个)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerTools(server: McpServer, projectId: string, user: string, onProjectChange?: (newProjectId: string, newApiUrl: string) => void): void;
+export declare function registerTools(server: McpServer, projectId: string, user: string, agentId: string, onProjectChange?: (newProjectId: string, newApiUrl: string) => void): void;

package/dist/tools/index.js

@@ -24,8 +24,8 @@ import { registerAnalyzerTools } from './analyzer.js';
 import { registerMeetingTools } from './meeting.js';
 import { registerFlowchartTools } from './flowchart.js';
 import { registerDocQueryTools } from './doc_query.js';
-export function registerTools(server, projectId, user, onProjectChange) {
-    const ctx = createContext(projectId, user);
+export function registerTools(server, projectId, user, agentId, onProjectChange) {
+    const ctx = createContext(projectId, user, agentId);
     // 🔗 初始化
     registerInitTool(server, ctx, onProjectChange || (() => { }));
     // 📊 导航

package/dist/tools/init.js

@@ -60,6 +60,7 @@ export function registerInitTool(server, ctx, onProjectChange) {
         // 4. 更新共享上下文 — 所有工具立刻获得新 projectId
         ctx.projectId = config.projectId;
         ctx.user = config.user;
+        ctx.agentId = process.env.PPDOCS_AGENT_ID || 'default';
         // 5. 通知主进程
         onProjectChange(config.projectId, config.apiUrl);
         return wrap(`✅ 项目上下文已初始化\n\n` +

package/dist/tools/shared.d.ts

@@ -6,9 +6,10 @@
 export interface McpContext {
     projectId: string;
     user: string;
+    agentId: string;
 }
 /** 创建可变上下文对象 (工具闭包捕获此对象的引用，kg_init 更新其属性) */
-export declare function createContext(projectId: string, user: string): McpContext;
+export declare function createContext(projectId: string, user: string, agentId?: string): McpContext;
 export declare function wrap(text: string): {
     content: {
         type: "text";

package/dist/tools/shared.js

@@ -3,8 +3,8 @@
  * 合并原 helpers.ts + 新增 safeTool / withCross 模式
  */
 /** 创建可变上下文对象 (工具闭包捕获此对象的引用，kg_init 更新其属性) */
-export function createContext(projectId, user) {
-    return { projectId, user };
+export function createContext(projectId, user, agentId = 'default') {
+    return { projectId, user, agentId };
 }
 // ==================== MCP 返回包装 ====================
 export function wrap(text) {

package/package.json

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