@znt/mcp 1.0.6 → 1.0.8

package/README.md

@@ -47,7 +47,7 @@
   * `role` *(string)*: Фильтр по архитектурной роли (`"controller"`, `"service"`, `"repository"`, `"model"`).
   * `type` *(string)*: Фильтр по типу узла AST (`"function"`, `"struct"`, `"class"`, `"interface"`).
   * `file_pattern` *(string)*: Маска пути файла (например `"pkg/semantic/*"` или `"*.go"`).
-  * `hybrid` *(boolean)*: Использовать гибридный RRF поиск (BM25 + Векторы, по умолчанию `true`).
+  * `mode` *(string)*: Режим поиска: `"hybrid"` (RRF гибридный), `"lexical"` (точный BM25/FTS5), `"vector"` (чисто векторный). По умолчанию `"hybrid"`.
 
 ---
 

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']
         },
@@ -346,7 +347,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           type: 'object',
           properties: {
             path: { type: 'string', description: 'Относительный или абсолютный путь к целевому файлу (например: "internal/engine/server.go")' },
-            include_code: { type: 'boolean', description: 'Включать ли фрагменты/сигнатуры исходного кода для каждого символа' }
+            include_code: { type: 'boolean', description: 'Включать ли фрагменты/сигнатуры исходного кода для каждого символа' },
+            format: { type: 'string', description: 'Формат ответа: "text" (сверхкомпактный атлас строк, экономит до 75% токенов) или "json"' }
           },
           required: ['path']
         },
@@ -409,9 +411,7 @@ async function callZntApi(endpoint, method = 'GET', body = null) {
               throw new Error(data.content);
             }
           } catch (err) {
-            if (!err.message.includes('JSON')) {
-              throw err;
-            }
+            // Ignore parse errors
           }
         }
       }
@@ -419,6 +419,11 @@ async function callZntApi(endpoint, method = 'GET', body = null) {
     return { content: text };
   }
 
+  const contentType = response.headers.get('content-type') || '';
+  if (contentType.includes('text/plain')) {
+    return response.text();
+  }
+
   return response.json();
 }
 
@@ -496,14 +501,17 @@ 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 +520,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           callees_level: calleesLevel.toString(),
           include_code: includeCode.toString(),
           max_code_lines: maxCodeLines.toString(),
-          hybrid: hybrid.toString(),
+          mode: mode,
+          format: 'text'
         });
+        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 +531,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;
@@ -571,11 +600,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           break;
         }
         const includeCode = Boolean(request.params.arguments?.include_code);
+        const format = request.params.arguments?.format || '';
 
         const queryParams = new URLSearchParams({
           path: filePath,
           include_code: includeCode.toString(),
         });
+        if (format) {
+          queryParams.set('format', format);
+        }
 
         const resData = await callZntApi(`/api/file/outline?${queryParams.toString()}`);
         result = resData;

package/package.json

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