@ppdocs/mcp 2.6.13 → 2.6.15

package/dist/tools/index.js

@@ -118,14 +118,14 @@ export function registerTools(server, projectId, _user) {
         return wrap(projectId, node ? JSON.stringify(node, null, 2) : '操作失败');
     });
     // 5. 搜索节点
-    server.tool('kg_search', '关键词搜索节点,按相关度排序返回', {
+    server.tool('kg_search', '关键词搜索节点,按命中率排序返回', {
         keywords: z.array(z.string()).describe('关键词列表(OR逻辑)'),
-        limit: z.number().optional().describe('返回数量(默认20)')
+        limit: z.number().optional().describe('返回数量(默认10)')
     }, async (args) => {
-        const results = await storage.searchNodes(projectId, args.keywords, args.limit);
+        const results = await storage.searchNodes(projectId, args.keywords, args.limit || 10);
         const output = results.map(r => ({
             id: r.node.id, title: r.node.title, type: r.node.type,
-            status: r.node.status, score: r.score.toFixed(1), matches: r.matches
+            status: r.node.status, hitRate: `${Math.round(r.score)}%`
         }));
         return wrap(projectId, JSON.stringify(output, null, 2));
     });
@@ -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.13",
+  "version": "2.6.15",
   "description": "ppdocs MCP Server - Knowledge Graph for Claude",
   "type": "module",
   "main": "dist/index.js",