syntax-map-mcp 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.1.8 - 2026-05-07
+
+- `docs/tools.md`의 도구 목록이 실제 MCP `listTools()` 응답과 일치하는지 검증하도록 했습니다.
+- MCP `listTools()` 응답의 공개 tool 이름과 주요 input schema 필드를 검증하는 테스트를 추가했습니다.
+- `release:check`가 npm 패키지를 tarball로 설치한 뒤 MCP 초기화 응답을 확인하는 smoke test를 실행하도록 했습니다.
+
+## 0.1.7 - 2026-05-07
+
+- `release:check`가 npm 패키징 dry-run 결과의 필수 파일 포함 여부를 자동 검증하도록 했습니다.
+- MCP 서버 metadata의 version이 `package.json` 버전과 동기화되도록 했습니다.
+
 ## 0.1.6 - 2026-05-06
 
 - 하위 디렉터리의 `.gitignore` 패턴도 인덱싱 대상 파일 제외에 반영하도록 했습니다.

package/dist/server.js

@@ -1,10 +1,24 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { registerTools } from './tools.js';
 import { createWorkspace } from './workspace.js';
+export async function createServerInfo() {
+    const packageJsonPath = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+    const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf8'));
+    if (typeof packageJson.version !== 'string') {
+        throw new Error('package.json version is missing');
+    }
+    return {
+        name: 'syntax-map-mcp',
+        version: packageJson.version
+    };
+}
 export async function createServer(options) {
     const workspace = await createWorkspace(options.workspaceRoot);
-    const server = new McpServer({ name: 'syntax-map-mcp', version: '0.1.0' }, {
+    const server = new McpServer(await createServerInfo(), {
         instructions: 'Analyze JavaScript, TypeScript, and Python source files under the configured workspaceRoot only.'
     });
     registerTools(server, workspace);

package/docs/tools.md

@@ -2,7 +2,7 @@
 
 syntax-map-mcp의 주요 MCP 도구 입력과 응답 예시입니다. 응답 예시는 핵심 필드만 보여줍니다.
 
-## summarize_file
+## list_symbols
 
 입력:
 
@@ -19,28 +19,26 @@ syntax-map-mcp의 주요 MCP 도구 입력과 응답 예시입니다. 응답 예
   "ok": true,
   "path": "src/index.ts",
   "language": "typescript",
-  "imports": ["import { createServer } from './server.js';"],
-  "exports": ["export async function main() {"],
-  "sources": {
-    "symbols": "ast",
-    "imports": "ast",
-    "exports": "ast"
-  }
+  "symbols": [
+    {
+      "name": "main",
+      "kind": "function",
+      "line": 3,
+      "column": 1
+    }
+  ]
 }
 ```
 
-## search_symbols
+## find_definition
 
 입력:
 
 ```json
 {
-  "query": "UserService",
-  "kinds": ["class"],
-  "refreshIfStale": true,
-  "contextBefore": 2,
-  "contextAfter": 2,
-  "includePreview": true
+  "name": "UserService",
+  "paths": ["src/users.ts", "src/index.ts"],
+  "kinds": ["class"]
 }
 ```
 
@@ -49,34 +47,24 @@ syntax-map-mcp의 주요 MCP 도구 입력과 응답 예시입니다. 응답 예
 ```json
 {
   "ok": true,
-  "isStale": false,
-  "refreshed": true,
-  "symbols": [
+  "definitions": [
     {
       "path": "src/users.ts",
       "name": "UserService",
-      "kind": "class",
-      "snippet": "export class UserService {",
-      "context": {
-        "before": ["export type UserId = User['id'];", ""],
-        "after": ["  constructor(private readonly users: User[]) {}", ""]
-      },
-      "previewMarkdown": "src/users.ts:8\n\n```typescript\nexport type UserId = User['id'];\n\nexport class UserService {\n  constructor(private readonly users: User[]) {}\n\n```"
+      "kind": "class"
     }
   ]
 }
 ```
 
-## find_indexed_definition
+## find_references
 
 입력:
 
 ```json
 {
-  "name": "UserService",
-  "refreshIfStale": true,
-  "contextBefore": 1,
-  "contextAfter": 1
+  "name": "formatUser",
+  "paths": ["src/users.ts", "src/index.ts"]
 }
 ```
 
@@ -85,27 +73,23 @@ syntax-map-mcp의 주요 MCP 도구 입력과 응답 예시입니다. 응답 예
 ```json
 {
   "ok": true,
-  "total": 1,
-  "definitions": [
+  "references": [
     {
-      "path": "src/users.ts",
-      "name": "UserService",
-      "kind": "class",
-      "snippet": "export class UserService {"
+      "path": "src/index.ts",
+      "name": "formatUser",
+      "nodeType": "identifier"
     }
   ]
 }
 ```
 
-## find_indexed_references
+## summarize_file
 
 입력:
 
 ```json
 {
-  "name": "formatUser",
-  "limit": 20,
-  "refreshIfStale": true
+  "path": "src/index.ts"
 }
 ```
 
@@ -114,12 +98,43 @@ syntax-map-mcp의 주요 MCP 도구 입력과 응답 예시입니다. 응답 예
 ```json
 {
   "ok": true,
-  "references": [
+  "path": "src/index.ts",
+  "language": "typescript",
+  "imports": ["import { createServer } from './server.js';"],
+  "exports": ["export async function main() {"],
+  "sources": {
+    "symbols": "ast",
+    "imports": "ast",
+    "exports": "ast"
+  }
+}
+```
+
+## run_query
+
+입력:
+
+```json
+{
+  "path": "src/users.ts",
+  "query": "(class_declaration name: (type_identifier) @class.name)"
+}
+```
+
+응답 일부:
+
+```json
+{
+  "ok": true,
+  "matches": [
     {
-      "path": "src/users.ts",
-      "name": "formatUser",
-      "nodeType": "identifier",
-      "snippet": "formatUser(defaultUser);"
+      "pattern": 0,
+      "captures": [
+        {
+          "name": "class.name",
+          "text": "UserService"
+        }
+      ]
     }
   ]
 }
@@ -187,6 +202,122 @@ syntax-map-mcp의 주요 MCP 도구 입력과 응답 예시입니다. 응답 예
 }
 ```
 
+## index_workspace
+
+입력:
+
+```json
+{}
+```
+
+응답 일부:
+
+```json
+{
+  "ok": true,
+  "indexedFiles": 12,
+  "symbols": 84,
+  "references": 231,
+  "indexPath": "/workspace/.syntax-map-mcp/index.sqlite"
+}
+```
+
+## search_symbols
+
+입력:
+
+```json
+{
+  "query": "UserService",
+  "kinds": ["class"],
+  "refreshIfStale": true,
+  "contextBefore": 2,
+  "contextAfter": 2,
+  "includePreview": true
+}
+```
+
+응답 일부:
+
+```json
+{
+  "ok": true,
+  "isStale": false,
+  "refreshed": true,
+  "symbols": [
+    {
+      "path": "src/users.ts",
+      "name": "UserService",
+      "kind": "class",
+      "snippet": "export class UserService {",
+      "context": {
+        "before": ["export type UserId = User['id'];", ""],
+        "after": ["  constructor(private readonly users: User[]) {}", ""]
+      },
+      "previewMarkdown": "src/users.ts:8\n\n```typescript\nexport type UserId = User['id'];\n\nexport class UserService {\n  constructor(private readonly users: User[]) {}\n\n```"
+    }
+  ]
+}
+```
+
+## find_indexed_definition
+
+입력:
+
+```json
+{
+  "name": "UserService",
+  "refreshIfStale": true,
+  "contextBefore": 1,
+  "contextAfter": 1
+}
+```
+
+응답 일부:
+
+```json
+{
+  "ok": true,
+  "total": 1,
+  "definitions": [
+    {
+      "path": "src/users.ts",
+      "name": "UserService",
+      "kind": "class",
+      "snippet": "export class UserService {"
+    }
+  ]
+}
+```
+
+## find_indexed_references
+
+입력:
+
+```json
+{
+  "name": "formatUser",
+  "limit": 20,
+  "refreshIfStale": true
+}
+```
+
+응답 일부:
+
+```json
+{
+  "ok": true,
+  "references": [
+    {
+      "path": "src/users.ts",
+      "name": "formatUser",
+      "nodeType": "identifier",
+      "snippet": "formatUser(defaultUser);"
+    }
+  ]
+}
+```
+
 ## get_index_status
 
 입력:
@@ -206,3 +337,21 @@ syntax-map-mcp의 주요 MCP 도구 입력과 응답 예시입니다. 응답 예
   "staleFiles": 0
 }
 ```
+
+## clear_index
+
+입력:
+
+```json
+{}
+```
+
+응답 일부:
+
+```json
+{
+  "ok": true,
+  "indexPath": "/workspace/.syntax-map-mcp/index.sqlite",
+  "deleted": true
+}
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "syntax-map-mcp",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Tree-sitter based code analysis MCP server",
   "license": "MIT",
   "type": "module",
@@ -31,7 +31,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "release:check": "npm run typecheck && npm test && npm run build && npm pack --dry-run"
+    "release:check": "npm run typecheck && npm test && npm run build && node scripts/check-package-files.mjs && node scripts/smoke-package-install.mjs"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",