@ppdocs/mcp 2.6.14 → 2.6.15

package/dist/tools/index.js

@@ -175,13 +175,13 @@ export function registerTools(server, projectId, _user) {
             for (const r of relations) {
                 if (r.direction === 'outgoing' && (direction === 'outgoing' || direction === 'both')) {
                     if (!outgoing.some(o => o.id === r.nodeId)) {
-                        outgoing.push({ id: r.nodeId, title: r.title, desc: r.description, edge: r.edgeType, depth: currentDepth });
+                        outgoing.push({ id: r.nodeId, title: r.title, edge: r.edgeType });
                         await fetchRelations(r.nodeId, currentDepth + 1, 'outgoing');
                     }
                 }
                 if (r.direction === 'incoming' && (direction === 'incoming' || direction === 'both')) {
                     if (!incoming.some(i => i.id === r.nodeId)) {
-                        incoming.push({ id: r.nodeId, title: r.title, desc: r.description, edge: r.edgeType, depth: currentDepth });
+                        incoming.push({ id: r.nodeId, title: r.title, edge: r.edgeType });
                         await fetchRelations(r.nodeId, currentDepth + 1, 'incoming');
                     }
                 }
@@ -193,6 +193,65 @@ export function registerTools(server, projectId, _user) {
         }
         return wrap(projectId, JSON.stringify({ outgoing, incoming }, null, 2));
     });
+    // 9. 读取单个节点详情
+    server.tool('kg_read_node', '读取单个节点的完整内容(描述、关联文件、依赖、历史记录)', {
+        nodeId: z.string().describe('节点ID')
+    }, async (args) => {
+        const node = await storage.getNode(projectId, args.nodeId);
+        if (!node) {
+            return wrap(projectId, '节点不存在');
+        }
+        // 构建结构化输出
+        const lines = [];
+        // 基础信息
+        lines.push(`## ${node.title}\n`);
+        lines.push('**基础信息**');
+        lines.push(`| 字段 | 值 |`);
+        lines.push(`|:---|:---|`);
+        lines.push(`| ID | ${node.id} |`);
+        lines.push(`| 类型 | ${node.type} |`);
+        lines.push(`| 状态 | ${node.status} |`);
+        lines.push(`| 签名 | ${node.signature} |`);
+        if (node.categories && node.categories.length > 0) {
+            lines.push(`| 标签 | ${node.categories.join(', ')} |`);
+        }
+        lines.push('');
+        // 关联文件
+        if (node.relatedFiles && node.relatedFiles.length > 0) {
+            lines.push('**关联文件**');
+            node.relatedFiles.forEach(f => lines.push(`- ${f}`));
+            lines.push('');
+        }
+        // 依赖关系
+        if (node.dependencies && node.dependencies.length > 0) {
+            lines.push('**依赖关系**');
+            node.dependencies.forEach(d => lines.push(`- ${d.name}: ${d.description}`));
+            lines.push('');
+        }
+        // 描述内容
+        if (node.description) {
+            lines.push('**描述内容**');
+            lines.push(node.description);
+            lines.push('');
+        }
+        // 更新历史
+        if (node.versions && node.versions.length > 0) {
+            lines.push('**更新历史**');
+            lines.push('| 版本 | 日期 | 变更 |');
+            lines.push('|:---|:---|:---|');
+            node.versions.forEach(v => lines.push(`| ${v.version} | ${v.date} | ${v.changes} |`));
+            lines.push('');
+        }
+        // 修复历史
+        if (node.bugfixes && node.bugfixes.length > 0) {
+            lines.push('**修复历史**');
+            lines.push('| ID | 日期 | 问题 | 方案 |');
+            lines.push('|:---|:---|:---|:---|');
+            node.bugfixes.forEach(b => lines.push(`| ${b.id} | ${b.date} | ${b.issue} | ${b.solution} |`));
+            lines.push('');
+        }
+        return wrap(projectId, lines.join('\n'));
+    });
     // ===================== 任务管理工具 =====================
     // 10. 创建任务
     server.tool('task_create', '创建开发任务,记录目标和关联节点', {

package/package.json

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