@reinteractive/rails-insight 1.0.6 → 1.0.8

package/README.md

@@ -1,6 +1,6 @@
 # RailsInsight
 
-[![npm version](https://img.shields.io/npm/v/@reinteractive/railsinsight.svg)](https://www.npmjs.com/package/@reinteractive/railsinsight)
+[![npm version](https://img.shields.io/npm/v/@reinteractive/rails-insight.svg)](https://www.npmjs.com/package/@reinteractive/rails-insight)
 [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](LICENSE)
 
 A Rails-aware codebase indexer that runs as an MCP (Model Context Protocol) server, giving AI coding agents deep structural understanding of your Rails application — models, associations, routes, schema, authentication, jobs, components, and 56 total file categories — without reading every file.
@@ -57,7 +57,7 @@ Add to your Claude Code MCP configuration:
   "mcpServers": {
     "railsinsight": {
       "command": "npx",
-      "args": ["@reinteractive/rails-insight"]
+      "args": ["-y", "@reinteractive/rails-insight"]
     }
   }
 }
@@ -72,7 +72,7 @@ In your `.cursor/mcp.json`:
   "mcpServers": {
     "railsinsight": {
       "command": "npx",
-      "args": ["@reinteractive/rails-insight"]
+      "args": ["-y", "@reinteractive/rails-insight"]
     }
   }
 }
@@ -88,14 +88,15 @@ In your VS Code `.mcp.json` file:
 {
   "servers": {
     "railsinsight": {
+      "type": "stdio",
       "command": "npx",
-      "args": ["@reinteractive/railsinsight"]
+      "args": ["-y", "@reinteractive/rails-insight"]
     }
   }
 }
 ```
 
-This configuration is required for the VS Code MCP extension, which expects the `servers` block and the package name to be `@reinteractive/railsinsight` (no hyphen).
+Note: VS Code MCP configuration uses the `servers` block (not `mcpServers` as used by Claude Desktop/Cursor). The `"type": "stdio"` field is required.
 
 ## Available Tools
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reinteractive/rails-insight",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Rails-aware codebase indexer — MCP server for AI agents",
   "type": "module",
   "bin": {
@@ -59,4 +59,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}

package/src/server.js

@@ -38,6 +38,36 @@ export async function startLocal(projectRoot, options = {}) {
   const provider = new LocalFSProvider(projectRoot)
   const verbose = options.verbose || false
 
+  // Connect the transport immediately so VS Code's MCP handshake completes
+  // without waiting for the index to be built. Tools return a "not ready"
+  // response until state.index is populated below.
+  const server = new McpServer({
+    name: 'railsinsight',
+    version: PKG_VERSION,
+    capabilities: { tools: {} },
+  })
+
+  const state = registerTools(server, {
+    index: null,
+    provider,
+    tier: options.tier || 'pro',
+    verbose,
+  })
+
+  const transport = new StdioServerTransport()
+  await server.connect(transport)
+
+  // Keep the event loop alive so Node.js doesn't exit when startLocal returns.
+  // StdioServerTransport adds a 'data' listener to stdin but does not call
+  // resume(), so without this the process exits immediately on idle stdin.
+  process.stdin.resume()
+
+  // Yield to the event loop before running the synchronous buildIndex pipeline.
+  // This lets the MCP SDK process the VS Code initialize handshake that arrived
+  // on stdin while we were awaiting connect(), preventing a timeout on the
+  // client side before any tools have been registered.
+  await new Promise((resolve) => setImmediate(resolve))
+
   if (verbose) {
     process.stderr.write(`[railsinsight] Indexing ${projectRoot}...\n`)
   }
@@ -47,19 +77,11 @@ export async function startLocal(projectRoot, options = {}) {
     verbose,
   })
 
+  state.index = index
+
   if (verbose) {
-    process.stderr.write(`[railsinsight] Index built. Starting MCP server...\n`)
+    process.stderr.write(`[railsinsight] Index built.\n`)
   }
-
-  const server = createServer({
-    index,
-    provider,
-    tier: options.tier || 'pro',
-    verbose,
-  })
-
-  const transport = new StdioServerTransport()
-  await server.connect(transport)
 }
 
 /**

package/src/tools/index.js

@@ -31,4 +31,6 @@ export function registerTools(server, options) {
   if (tier === 'pro' || tier === 'team') {
     registerProTools(server, state)
   }
+
+  return state
 }