syntax-map-mcp 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 1.2.0 - 2026-05-07
+
+- `lsp_diagnostics` 도구를 추가해 tree-sitter parse error 기반의 가벼운 문법 진단을 LSP Diagnostic 형태로 반환하도록 했습니다.
+- diagnostics 분석 계층에 provider 인터페이스를 추가해 이후 언어별 LSP 서버 진단 결과를 결합할 수 있게 했습니다.
+
 ## 1.1.0 - 2026-05-07
 
 - Rust `.rs` 파일 파싱을 지원하고, `get_ast_tree`와 LSP document symbols, definition, references, hover, workspace symbols, completion, signature help에서 Rust 심볼을 처리하도록 했습니다.

package/README.md

@@ -37,6 +37,7 @@ npx -y syntax-map-mcp --workspace-root /path/to/workspace
 - `run_query`: 파일 하나에 tree-sitter query 실행
 - `get_ast_tree`: 파일 하나의 tree-sitter AST를 depth 제한 JSON 트리로 반환
 - `lsp_document_symbols`: 파일 하나의 심볼을 LSP DocumentSymbol 형태로 반환
+- `lsp_diagnostics`: 파일 하나의 tree-sitter parse error를 LSP Diagnostic 형태로 반환
 - `lsp_definition`: 파일의 LSP 위치에 있는 식별자의 정의 위치를 반환
 - `lsp_references`: 파일의 LSP 위치에 있는 식별자의 참조 위치를 반환
 - `lsp_hover`: 파일의 LSP 위치에 있는 식별자의 hover markdown을 반환

package/dist/analysis/diagnostics.js

@@ -0,0 +1,73 @@
+import { parseSourceFile } from '../parser.js';
+export const treeSitterDiagnosticProvider = {
+    name: 'tree-sitter',
+    getDiagnostics(context) {
+        return collectTreeSitterDiagnostics(context.tree.rootNode);
+    }
+};
+const defaultDiagnosticProviders = [treeSitterDiagnosticProvider];
+export async function getDiagnostics(workspace, input, providers = defaultDiagnosticProviders) {
+    const file = await workspace.readSourceFile(input.path);
+    if (!file.ok)
+        return file;
+    const parsed = parseSourceFile(file);
+    /* v8 ignore next -- parser failures are covered by parser tests. */
+    if (!parsed.ok)
+        return parsed;
+    const context = diagnosticContext(parsed);
+    const diagnostics = (await Promise.all(providers.map(provider => Promise.resolve(provider.getDiagnostics(context))))).flat();
+    return {
+        ok: true,
+        path: file.relativePath,
+        language: parsed.language,
+        diagnostics
+    };
+}
+function diagnosticContext(parsed) {
+    return {
+        path: parsed.file.relativePath,
+        language: parsed.language,
+        text: parsed.file.text,
+        tree: parsed.tree
+    };
+}
+function collectTreeSitterDiagnostics(root) {
+    if (!root.hasError)
+        return [];
+    const diagnostics = [];
+    collectErrorNodes(root, diagnostics);
+    return diagnostics;
+}
+function collectErrorNodes(node, diagnostics) {
+    if (node.isError || node.isMissing) {
+        diagnostics.push({
+            range: lspRange(rangeForNode(node)),
+            severity: 1,
+            source: 'tree-sitter',
+            message: node.isMissing ? `Syntax error: missing ${node.type}` : 'Syntax error'
+        });
+    }
+    if (!node.hasError)
+        return;
+    for (const child of node.children) {
+        collectErrorNodes(child, diagnostics);
+    }
+}
+function lspRange(range) {
+    return {
+        start: {
+            line: range.start.row,
+            character: range.start.column
+        },
+        end: {
+            line: range.end.row,
+            character: range.end.column
+        }
+    };
+}
+function rangeForNode(node) {
+    return {
+        start: node.startPosition,
+        end: node.endPosition
+    };
+}

package/dist/tools.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { getAstTree as getAstTreeAnalysis } from './analysis/ast-tree.js';
 import { buildContext as buildContextAnalysis } from './analysis/context.js';
 import { findDefinitions } from './analysis/definitions.js';
+import { getDiagnostics as getLspDiagnostics } from './analysis/diagnostics.js';
 import { clearIndex as clearWorkspaceIndex, findIndexedDefinitions, findIndexedReferences, getIndexStatus as getWorkspaceIndexStatus, indexWorkspace as indexWorkspaceAnalysis, searchSymbols as searchIndexedSymbols } from './analysis/index.js';
 import { runTreeSitterQuery } from './analysis/query.js';
 import { findReferences as findReferencesAnalysis } from './analysis/references.js';
@@ -75,6 +76,12 @@ export function createToolHandlers(workspace) {
                 return toolFailure(result.error.code, result.error.message);
             return jsonResult(result);
         },
+        async lspDiagnostics(input) {
+            const result = await getLspDiagnostics(workspace, input);
+            if (!result.ok)
+                return toolFailure(result.error.code, result.error.message);
+            return jsonResult(result);
+        },
         async lspDefinition(input) {
             const result = await getLspDefinition(workspace, input);
             if (!result.ok)
@@ -214,6 +221,13 @@ export function registerTools(server, workspace) {
             path: z.string()
         }
     }, handlers.lspDocumentSymbols);
+    server.registerTool('lsp_diagnostics', {
+        title: 'LSP diagnostics',
+        description: 'Return lightweight syntax diagnostics from tree-sitter parse errors.',
+        inputSchema: {
+            path: z.string()
+        }
+    }, handlers.lspDiagnostics);
     server.registerTool('lsp_definition', {
         title: 'LSP definition',
         description: 'Return definition locations for the identifier at a zero-based LSP position.',

package/docs/tools.md

@@ -215,6 +215,37 @@ syntax-map-mcp의 주요 MCP 도구 입력과 응답 예시입니다. 응답 예
 }
 ```
 
+## lsp_diagnostics
+
+입력:
+
+```json
+{
+  "path": "src/users.ts"
+}
+```
+
+응답 일부:
+
+```json
+{
+  "ok": true,
+  "path": "src/users.ts",
+  "language": "typescript",
+  "diagnostics": [
+    {
+      "range": {
+        "start": { "line": 10, "character": 4 },
+        "end": { "line": 10, "character": 12 }
+      },
+      "severity": 1,
+      "source": "tree-sitter",
+      "message": "Syntax error"
+    }
+  ]
+}
+```
+
 ## lsp_definition
 
 입력:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "syntax-map-mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Tree-sitter based code analysis MCP server",
   "license": "MIT",
   "type": "module",