kiri-mcp-server 0.3.0 → 0.4.0

package/README.md

@@ -111,15 +111,15 @@ KIRI provides 5 MCP tools for code exploration:
 
 | Tool                | Description                                                           |
 | ------------------- | --------------------------------------------------------------------- |
-| **context.bundle**  | Extract relevant code context based on task goals                     |
-| **semantic.rerank** | Re-rank candidates by semantic similarity                             |
-| **files.search**    | Full-text search with multi-word queries (FTS/BM25 or ILIKE fallback) |
-| **snippets.get**    | Retrieve code snippets with symbol boundaries                         |
-| **deps.closure**    | Get dependency graph neighborhood (outbound/inbound)                  |
+| **context_bundle**  | Extract relevant code context based on task goals                     |
+| **semantic_rerank** | Re-rank candidates by semantic similarity                             |
+| **files_search**    | Full-text search with multi-word queries (FTS/BM25 or ILIKE fallback) |
+| **snippets_get**    | Retrieve code snippets with symbol boundaries                         |
+| **deps_closure**    | Get dependency graph neighborhood (outbound/inbound)                  |
 
 ### Search Query Syntax
 
-**files.search** supports multi-word queries automatically:
+**files_search** supports multi-word queries automatically:
 
 - `"tools call implementation"` → Finds files containing ANY of these words (OR logic)
 - `"MCP-server-handler"` → Splits on hyphens and searches for each part

package/config/default.example.yml

@@ -2,8 +2,8 @@ mcp:
   port: 8765
   host: 127.0.0.1
   tools:
-    - context.bundle
-    - files.search
+    - context_bundle
+    - files_search
 indexer:
   repoRoot: "../../target-repo"
   database: "var/index.duckdb"

package/config/scoring-profiles.yml

@@ -1,4 +1,4 @@
-# Scoring weight profiles for context.bundle
+# Scoring weight profiles for context_bundle
 # Each profile defines weights for different ranking signals
 
 default:

package/dist/config/default.example.yml

@@ -2,8 +2,8 @@ mcp:
   port: 8765
   host: 127.0.0.1
   tools:
-    - context.bundle
-    - files.search
+    - context_bundle
+    - files_search
 indexer:
   repoRoot: "../../target-repo"
   database: "var/index.duckdb"

package/dist/config/scoring-profiles.yml

@@ -1,4 +1,4 @@
-# Scoring weight profiles for context.bundle
+# Scoring weight profiles for context_bundle
 # Each profile defines weights for different ranking signals
 
 default:

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "kiri-mcp-server",
-    "version": "0.3.0",
+    "version": "0.4.0",
     "description": "KIRI context extraction platform",
     "type": "module",
     "packageManager": "pnpm@9.0.0",

package/dist/src/server/fallbacks/degradeController.js

@@ -68,7 +68,7 @@ export class DegradeController {
     }
     async withResource(operation, reason) {
         if (this.state.active) {
-            throw new Error(`Server is running in degrade mode: ${this.state.reason ?? "unknown"}. Only files.search is available.`);
+            throw new Error(`Server is running in degrade mode: ${this.state.reason ?? "unknown"}. Only files_search is available.`);
         }
         try {
             const result = await operation();

package/dist/src/server/handlers.js

@@ -453,7 +453,7 @@ export async function filesSearch(context, params) {
     const { db, repoId } = context;
     const { query } = params;
     if (!query || query.trim().length === 0) {
-        throw new Error("files.search requires a non-empty query. Provide a search keyword to continue.");
+        throw new Error("files_search requires a non-empty query. Provide a search keyword to continue.");
     }
     const limit = normalizeLimit(params.limit);
     const hasFTS = context.features?.fts ?? false;
@@ -550,7 +550,7 @@ export async function filesSearch(context, params) {
 export async function snippetsGet(context, params) {
     const { db, repoId } = context;
     if (!params.path) {
-        throw new Error("snippets.get requires a file path. Specify a tracked text file path to continue.");
+        throw new Error("snippets_get requires a file path. Specify a tracked text file path to continue.");
     }
     const rows = await db.all(`
       SELECT f.path, f.lang, f.ext, f.is_binary, b.content
@@ -630,7 +630,7 @@ export async function contextBundle(context, params) {
     const { db, repoId } = context;
     const goal = params.goal?.trim() ?? "";
     if (goal.length === 0) {
-        throw new Error("context.bundle requires a non-empty goal. Describe your objective to receive context.");
+        throw new Error("context_bundle requires a non-empty goal. Describe your objective to receive context.");
     }
     const limit = normalizeBundleLimit(params.limit);
     const artifacts = params.artifacts ?? {};
@@ -880,7 +880,7 @@ export async function contextBundle(context, params) {
 export async function semanticRerank(context, params) {
     const text = params.text?.trim() ?? "";
     if (text.length === 0) {
-        throw new Error("semantic.rerank requires non-empty text. Describe the intent to compute semantic similarity.");
+        throw new Error("semantic_rerank requires non-empty text. Describe the intent to compute semantic similarity.");
     }
     if (!Array.isArray(params.candidates) || params.candidates.length === 0) {
         return { candidates: [] };
@@ -948,7 +948,7 @@ export async function semanticRerank(context, params) {
 export async function depsClosure(context, params) {
     const { db, repoId } = context;
     if (!params.path) {
-        throw new Error("deps.closure requires a file path. Provide a tracked source file path to continue.");
+        throw new Error("deps_closure requires a file path. Provide a tracked source file path to continue.");
     }
     const direction = params.direction ?? "outbound";
     const maxDepth = params.max_depth ?? 3;

package/dist/src/server/rpc.js

@@ -8,7 +8,7 @@ const SERVER_INFO = {
 };
 const TOOL_DESCRIPTORS = [
     {
-        name: "context.bundle",
+        name: "context_bundle",
         description: "🎯 PRIMARY TOOL: Extracts relevant code context for a specific task or question.\n\n" +
             "Use this tool as your first step for any code-related task. It intelligently finds and ranks relevant files and code snippets using keyword matching, dependency analysis, and semantic similarity.\n\n" +
             "IMPORTANT: The 'goal' parameter MUST be a clear and specific description of your objective. Use concrete keywords, not abstract verbs.\n\n" +
@@ -82,7 +82,7 @@ const TOOL_DESCRIPTORS = [
         },
     },
     {
-        name: "semantic.rerank",
+        name: "semantic_rerank",
         description: "Re-rank a list of file candidates by semantic similarity to a query text. Uses structural embeddings to compute similarity scores and combines them with existing scores. Use as a REFINEMENT step after files.search or when you have a list of candidates and want to prioritize them by semantic relevance. Not needed with context.bundle (which already does semantic ranking internally). Returns candidates sorted by combined score (base + semantic similarity). Example: after getting 20 search results, rerank them by semantic similarity to 'user authentication flow' to surface the most contextually relevant files.",
         inputSchema: {
             type: "object",
@@ -108,7 +108,7 @@ const TOOL_DESCRIPTORS = [
         },
     },
     {
-        name: "files.search",
+        name: "files_search",
         description: "Search files by specific keywords or identifiers. Use when you know EXACT terms to search for: function names, class names, error messages, or code patterns.\n\n" +
             "IMPORTANT: For broader exploration like 'understand feature X' or 'how does Y work', use context.bundle instead. This tool is for TARGETED searches with specific identifiers.\n\n" +
             "✅ GOOD EXAMPLES (specific identifiers):\n" +
@@ -161,7 +161,7 @@ const TOOL_DESCRIPTORS = [
         },
     },
     {
-        name: "snippets.get",
+        name: "snippets_get",
         description: "Retrieve code snippets from a specific file path. Intelligently extracts relevant code sections using symbol boundaries (functions, classes, methods) when available. Use when you already know the exact file path and want to read its content efficiently without loading the entire file. Automatically selects appropriate snippet based on start_line or returns symbol-aligned chunks. Reduces token usage compared to reading full files. Use context.bundle instead if you don't know which file to read. Example: path='src/auth/login.ts' returns the most relevant function or class in that file.",
         inputSchema: {
             type: "object",
@@ -175,7 +175,7 @@ const TOOL_DESCRIPTORS = [
         },
     },
     {
-        name: "deps.closure",
+        name: "deps_closure",
         description: "Traverse the dependency graph from a starting file. Finds all files that depend on the target (inbound) or that the target depends on (outbound). Essential for impact analysis: understanding what breaks if you change a file, tracing import chains, or mapping module relationships. Returns nodes (files/packages) and edges (import statements) with depth levels. Use when: planning refactoring, understanding module boundaries, finding circular dependencies, or analyzing affected files. Example: path='src/utils.ts', direction='inbound' shows all files importing utils.ts. Set max_depth to limit traversal (default 3).",
         inputSchema: {
             type: "object",
@@ -417,17 +417,17 @@ export function validateJsonRpcRequest(payload) {
 // Helper function to execute a tool by name
 async function executeToolByName(toolName, toolParams, context, degrade, allowDegrade) {
     switch (toolName) {
-        case "context.bundle": {
+        case "context_bundle": {
             const params = parseContextBundleParams(toolParams);
-            const handler = async () => await withSpan("context.bundle", async () => await contextBundle(context, params));
-            return await degrade.withResource(handler, "duckdb:context.bundle");
+            const handler = async () => await withSpan("context_bundle", async () => await contextBundle(context, params));
+            return await degrade.withResource(handler, "duckdb:context_bundle");
         }
-        case "semantic.rerank": {
+        case "semantic_rerank": {
             const params = parseSemanticRerankParams(toolParams);
-            const handler = async () => await withSpan("semantic.rerank", async () => await semanticRerank(context, params));
-            return await degrade.withResource(handler, "duckdb:semantic.rerank");
+            const handler = async () => await withSpan("semantic_rerank", async () => await semanticRerank(context, params));
+            return await degrade.withResource(handler, "duckdb:semantic_rerank");
         }
-        case "files.search": {
+        case "files_search": {
             const params = parseFilesSearchParams(toolParams);
             if (degrade.current.active && allowDegrade) {
                 return {
@@ -443,19 +443,19 @@ async function executeToolByName(toolName, toolParams, context, degrade, allowDe
                 };
             }
             else {
-                const handler = async () => await withSpan("files.search", async () => await filesSearch(context, params));
-                return await degrade.withResource(handler, "duckdb:files.search");
+                const handler = async () => await withSpan("files_search", async () => await filesSearch(context, params));
+                return await degrade.withResource(handler, "duckdb:files_search");
             }
         }
-        case "snippets.get": {
+        case "snippets_get": {
             const params = parseSnippetsGetParams(toolParams);
-            const handler = async () => await withSpan("snippets.get", async () => await snippetsGet(context, params));
-            return await degrade.withResource(handler, "duckdb:snippets.get");
+            const handler = async () => await withSpan("snippets_get", async () => await snippetsGet(context, params));
+            return await degrade.withResource(handler, "duckdb:snippets_get");
         }
-        case "deps.closure": {
+        case "deps_closure": {
             const params = parseDepsClosureParams(toolParams);
-            const handler = async () => await withSpan("deps.closure", async () => await depsClosure(context, params));
-            return await degrade.withResource(handler, "duckdb:deps.closure");
+            const handler = async () => await withSpan("deps_closure", async () => await depsClosure(context, params));
+            return await degrade.withResource(handler, "duckdb:deps_closure");
         }
         default:
             throw new Error(`Unknown tool: ${toolName}`);
@@ -546,31 +546,31 @@ export function createRpcHandler(dependencies) {
                     break;
                 }
                 // Legacy direct method invocation (backward compatibility)
-                case "context.bundle": {
-                    result = await executeToolByName("context.bundle", payload.params, context, degrade, allowDegrade);
+                case "context_bundle": {
+                    result = await executeToolByName("context_bundle", payload.params, context, degrade, allowDegrade);
                     break;
                 }
-                case "semantic.rerank": {
-                    result = await executeToolByName("semantic.rerank", payload.params, context, degrade, allowDegrade);
+                case "semantic_rerank": {
+                    result = await executeToolByName("semantic_rerank", payload.params, context, degrade, allowDegrade);
                     break;
                 }
-                case "files.search": {
-                    result = await executeToolByName("files.search", payload.params, context, degrade, allowDegrade);
+                case "files_search": {
+                    result = await executeToolByName("files_search", payload.params, context, degrade, allowDegrade);
                     break;
                 }
-                case "snippets.get": {
-                    result = await executeToolByName("snippets.get", payload.params, context, degrade, allowDegrade);
+                case "snippets_get": {
+                    result = await executeToolByName("snippets_get", payload.params, context, degrade, allowDegrade);
                     break;
                 }
-                case "deps.closure": {
-                    result = await executeToolByName("deps.closure", payload.params, context, degrade, allowDegrade);
+                case "deps_closure": {
+                    result = await executeToolByName("deps_closure", payload.params, context, degrade, allowDegrade);
                     break;
                 }
                 default: {
                     return hasResponseId
                         ? {
                             statusCode: 404,
-                            response: errorResponse(payload.id, "Requested method is not available. Use tools/call, or legacy methods: context.bundle, semantic.rerank, files.search, snippets.get, or deps.closure.", -32601),
+                            response: errorResponse(payload.id, "Requested method is not available. Use tools/call, or legacy methods: context_bundle, semantic_rerank, files_search, snippets_get, or deps_closure.", -32601),
                         }
                         : null;
                 }
@@ -601,8 +601,8 @@ export function createRpcHandler(dependencies) {
                     ? {
                         statusCode: 503,
                         response: errorResponse(payload.id, degrade.current.reason
-                            ? `Backend degraded due to ${degrade.current.reason}. Only files.search is operational.`
-                            : "Backend degraded. Only files.search is operational."),
+                            ? `Backend degraded due to ${degrade.current.reason}. Only files_search is operational.`
+                            : "Backend degraded. Only files_search is operational."),
                     }
                     : null;
             }

package/dist/src/server/scoring.d.ts

@@ -1,6 +1,6 @@
 /**
  * スコアリングウェイトの設定
- * context.bundle の候補ファイルに対するスコアリング重みを定義
+ * context_bundle の候補ファイルに対するスコアリング重みを定義
  */
 export interface ScoringWeights {
     /** テキストマッチ（キーワード検索）の重み */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiri-mcp-server",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "KIRI context extraction platform",
   "type": "module",
   "packageManager": "pnpm@9.0.0",