@znt/mcp 1.0.5 → 1.0.7

package/README.md

@@ -1,6 +1,11 @@
-# Znt MCP Adapter (@znt/mcp v1.1.0)
+# Znt MCP Adapter ([@znt/mcp](https://www.npmjs.com/package/@znt/mcp))
 
-Официальный адаптер **Model Context Protocol (MCP)** для системы локального понимания кодовых баз и графового анализа **Знаток (Znt)**.
+Официальный адаптер **Model Context Protocol (MCP)** для системы локального понимания кодовых баз и графового анализа **[Знаток (Znt)](https://github.com/boottaa/znt)**.
+
+## 🔗 Ссылки
+* 📦 **npm пакет**: [https://www.npmjs.com/package/@znt/mcp](https://www.npmjs.com/package/@znt/mcp)
+* 🚀 **Основной репозиторий Znt**: [https://github.com/boottaa/znt](https://github.com/boottaa/znt)
+* 🛠 **Репозиторий MCP-адаптера**: [https://github.com/boottaa/znt_mcp](https://github.com/boottaa/znt_mcp)
 
 Позволяет внешним ИИ-агентам и LLM-клиентам (Claude Desktop, Antigravity IDE, Cursor, Windsurf, Zed, Codex и др.) осуществлять гибридный и мультифакторный поиск по смыслу, получать семантические оглавления файлов, строить графы вызовов и трассировать зависимости с прозрачным трекингом экономии контекстных токенов.
 

package/index.js

@@ -293,14 +293,15 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           properties: {
             query: { type: 'string', description: 'Поисковый запрос на естественном языке (например: "обработка HTTP запросов в сервере")' },
             limit: { type: 'number', description: 'Максимальное количество результатов поиска (по умолчанию 10)' },
-            callers_level: { type: 'number', description: 'Глубина вложенности графа входящих вызовов ("где вызывается"), по умолчанию 3' },
-            callees_level: { type: 'number', description: 'Глубина вложенности графа исходящих вызовов ("где вызывают"), по умолчанию 3' },
+            callers_level: { type: 'number', description: 'Глубина вложенности графа входящих вызовов ("где вызывается"), по умолчанию 0' },
+            callees_level: { type: 'number', description: 'Глубина вложенности графа исходящих вызовов ("где вызывают"), по умолчанию 0' },
+            compact: { type: 'boolean', description: 'Возвращать только компактный DTO {name, file, start_line, end_line, summary, role, type, score} без графа связей' },
             include_code: { type: 'boolean', description: 'Включать ли исходный код (фрагмент узла) в результаты поиска' },
             max_code_lines: { type: 'number', description: 'Максимальное количество строк исходного кода (по умолчанию 30)' },
             role: { type: 'string', description: 'Фильтр по архитектурной роли компонента (например: "controller", "repository", "service", "model")' },
             type: { type: 'string', description: 'Фильтр по типу узла AST (например: "function", "struct", "class", "interface")' },
             file_pattern: { type: 'string', description: 'Шаблон/маска пути файла для фильтрации (например: "pkg/semantic/*" или "*.go")' },
-            hybrid: { type: 'boolean', description: 'Использовать гибридный поиск (RRF: BM25/Лексика + Векторы, по умолчанию true)' }
+            mode: { type: 'string', description: 'Режим поиска: "hybrid" (RRF гибридный), "lexical" (точный BM25/FTS5), "vector" (чисто векторный). По умолчанию "hybrid"' }
           },
           required: ['query']
         },
@@ -496,14 +497,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           break;
         }
         const limit = Math.min(Math.max(1, parseInt(request.params.arguments?.limit, 10) || 10), 100);
-        const callersLevel = Math.min(Math.max(0, parseInt(request.params.arguments?.callers_level ?? request.params.arguments?.caller_level, 10) ?? 3), 10);
-        const calleesLevel = Math.min(Math.max(0, parseInt(request.params.arguments?.callees_level ?? request.params.arguments?.callee_level, 10) ?? 3), 10);
+        const callersLevelArg = request.params.arguments?.callers_level ?? request.params.arguments?.caller_level;
+        const callersLevel = Math.min(Math.max(0, callersLevelArg !== undefined ? (parseInt(callersLevelArg, 10) || 0) : 0), 10);
+        const calleesLevelArg = request.params.arguments?.callees_level ?? request.params.arguments?.callee_level;
+        const calleesLevel = Math.min(Math.max(0, calleesLevelArg !== undefined ? (parseInt(calleesLevelArg, 10) || 0) : 0), 10);
+        const compact = Boolean(request.params.arguments?.compact);
         const includeCode = Boolean(request.params.arguments?.include_code);
         const maxCodeLines = parseInt(request.params.arguments?.max_code_lines, 10) || 30;
         const role = request.params.arguments?.role || '';
         const nodeType = request.params.arguments?.type || '';
-        const filePattern = request.params.arguments?.file_pattern || '';
-        const hybrid = request.params.arguments?.hybrid !== false;
+        const mode = request.params.arguments?.mode || (request.params.arguments?.hybrid === false ? 'lexical' : 'hybrid');
 
         const apiParams = new URLSearchParams({
           q: query,
@@ -512,8 +515,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           callees_level: calleesLevel.toString(),
           include_code: includeCode.toString(),
           max_code_lines: maxCodeLines.toString(),
-          hybrid: hybrid.toString(),
+          mode: mode,
         });
+        if (compact) apiParams.set('compact', 'true');
         if (role) apiParams.set('role', role);
         if (nodeType) apiParams.set('type', nodeType);
         if (filePattern) apiParams.set('file_pattern', filePattern);
@@ -521,16 +525,35 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const rawResults = await callZntApi(`/api/search?${apiParams.toString()}`);
         let processed = Array.isArray(rawResults) ? rawResults.map(item => {
           const relFile = toRelativePath(item.file || item.file_path || item.filePath);
+          let codeSnippet = item.code;
+          if (includeCode && !codeSnippet && relFile && item.start_line && item.end_line) {
+            let endLine = item.end_line;
+            if (maxCodeLines > 0 && (endLine - item.start_line + 1) > maxCodeLines) {
+              endLine = item.start_line + maxCodeLines - 1;
+            }
+            codeSnippet = getSourceSnippet(relFile, item.start_line, endLine);
+          }
+
+          if (compact) {
+            return {
+              name: item.name,
+              file: relFile,
+              start_line: item.start_line,
+              end_line: item.end_line,
+              summary: item.summary,
+              role: item.role,
+              type: item.type,
+              score: item.score,
+              ...(codeSnippet ? { code: codeSnippet } : {})
+            };
+          }
+
           const resItem = {
             ...item,
             file: relFile
           };
-          if (includeCode && !resItem.code && resItem.file && resItem.start_line && resItem.end_line) {
-            let endLine = resItem.end_line;
-            if (maxCodeLines > 0 && (endLine - resItem.start_line + 1) > maxCodeLines) {
-              endLine = resItem.start_line + maxCodeLines - 1;
-            }
-            resItem.code = getSourceSnippet(resItem.file, resItem.start_line, endLine);
+          if (codeSnippet) {
+            resItem.code = codeSnippet;
           }
           return resItem;
         }) : rawResults;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@znt/mcp",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Model Context Protocol adapter for Znt",
   "main": "index.js",
   "type": "module",