@aiready/mcp-server 0.1.18 → 0.1.20

package/.turbo/turbo-build.log

@@ -1,17 +1,16 @@
-
-
-> @aiready/mcp-server@0.1.18 build /Users/pengcao/projects/aiready/packages/mcp-server
-> tsup src/index.ts --format esm --clean --dts
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/pengcao/projects/aiready/packages/mcp-server/tsup.config.ts
-CLI Target: node20
-CLI Cleaning output folder
-ESM Build start
-ESM dist/index.js 2.90 KB
-ESM ⚡️ Build success in 18ms
-DTS Build start
-DTS ⚡️ Build success in 1451ms
-DTS dist/index.d.ts 430.00 B
+
+> @aiready/mcp-server@0.1.20 build /Users/pengcao/projects/aiready/packages/mcp-server
+> tsup src/index.ts --format esm --clean --dts
+
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/pengcao/projects/aiready/packages/mcp-server/tsup.config.ts
+CLI Target: node20
+CLI Cleaning output folder
+ESM Build start
+ESM dist/index.js 4.81 KB
+ESM ⚡️ Build success in 21ms
+DTS Build start
+DTS ⚡️ Build success in 1852ms
+DTS dist/index.d.ts 430.00 B

package/.turbo/turbo-lint.log

@@ -1,5 +1,4 @@
-
-
-> @aiready/mcp-server@0.1.17 lint /Users/pengcao/projects/aiready/packages/mcp-server
-> eslint src
-
+
+> @aiready/mcp-server@0.1.19 lint /Users/pengcao/projects/aiready/packages/mcp-server
+> eslint src
+

package/.turbo/turbo-test.log

@@ -1,19 +1,20 @@
-
-
-> @aiready/mcp-server@0.1.17 test /Users/pengcao/projects/aiready/packages/mcp-server
-> vitest run
-
-[?25l
- RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/mcp-server
-
-AIReady MCP Server started
-[MCP] Executing pattern-detect on /Users/pengcao/projects/aiready/packages/core
- ✓ src/__tests__/server.test.ts (5 tests) 1542ms
-     ✓ should execute pattern-detect and return results  681ms
-
- Test Files  1 passed (1)
-      Tests  5 passed (5)
-   Start at  13:03:48
-   Duration  1.82s (transform 47ms, setup 0ms, import 77ms, tests 1.54s, environment 0ms)
-
-[?25h
+
+> @aiready/mcp-server@0.1.19 test /Users/pengcao/projects/aiready/packages/mcp-server
+> vitest run
+
+
+ RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/mcp-server
+
+AIReady MCP Server started
+[MCP] Dynamically loading @aiready/pattern-detect for tool pattern-detect
+[MCP] Executing pattern-detect on /Users/pengcao/projects/aiready/packages/core
+[MCP] Dynamically loading @aiready/non-existent-tool for tool non-existent-tool
+[MCP] Failed to load tool package @aiready/non-existent-tool: Cannot find package '@aiready/non-existent-tool' imported from /Users/pengcao/projects/aiready/packages/mcp-server/dist/index.js
+ ✓ src/__tests__/server.test.ts (5 tests) 760ms
+     ✓ should execute pattern-detect and return results  423ms
+
+ Test Files  1 passed (1)
+      Tests  5 passed (5)
+   Start at  19:03:38
+   Duration  1.03s (transform 38ms, setup 0ms, import 75ms, tests 760ms, environment 0ms)
+

package/dist/index.js

@@ -7,10 +7,29 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
-import { ToolRegistry } from "@aiready/core";
-import "@aiready/pattern-detect";
-import "@aiready/context-analyzer";
-import "@aiready/consistency";
+import { ToolRegistry, ToolName } from "@aiready/core";
+var TOOL_PACKAGE_MAP = {
+  [ToolName.PatternDetect]: "@aiready/pattern-detect",
+  [ToolName.ContextAnalyzer]: "@aiready/context-analyzer",
+  [ToolName.NamingConsistency]: "@aiready/consistency",
+  [ToolName.AiSignalClarity]: "@aiready/ai-signal-clarity",
+  [ToolName.AgentGrounding]: "@aiready/agent-grounding",
+  [ToolName.TestabilityIndex]: "@aiready/testability",
+  [ToolName.DocDrift]: "@aiready/doc-drift",
+  [ToolName.DependencyHealth]: "@aiready/deps",
+  [ToolName.ChangeAmplification]: "@aiready/change-amplification",
+  // Aliases
+  patterns: "@aiready/pattern-detect",
+  duplicates: "@aiready/pattern-detect",
+  context: "@aiready/context-analyzer",
+  fragmentation: "@aiready/context-analyzer",
+  consistency: "@aiready/consistency",
+  "ai-signal": "@aiready/ai-signal-clarity",
+  grounding: "@aiready/agent-grounding",
+  testability: "@aiready/testability",
+  "deps-health": "@aiready/deps",
+  "change-amp": "@aiready/change-amplification"
+};
 var AIReadyMcpServer = class {
   constructor() {
     this.server = new Server(
@@ -31,11 +50,21 @@ var AIReadyMcpServer = class {
   }
   setupHandlers() {
     this.server.setRequestHandler(ListToolsRequestSchema, async () => {
-      const providers = ToolRegistry.getAll();
+      const toolsToAdvertise = [
+        ToolName.PatternDetect,
+        ToolName.ContextAnalyzer,
+        ToolName.NamingConsistency,
+        ToolName.AiSignalClarity,
+        ToolName.AgentGrounding,
+        ToolName.TestabilityIndex,
+        ToolName.DocDrift,
+        ToolName.DependencyHealth,
+        ToolName.ChangeAmplification
+      ];
       return {
-        tools: providers.map((p) => ({
-          name: p.id,
-          description: `AIReady analysis tool: ${p.id}`,
+        tools: toolsToAdvertise.map((id) => ({
+          name: id,
+          description: `AIReady analysis tool: ${id}`,
           inputSchema: {
             type: "object",
             properties: {
@@ -53,9 +82,28 @@ var AIReadyMcpServer = class {
     this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const { name, arguments: args } = request.params;
       try {
-        const provider = ToolRegistry.find(name);
+        let provider = ToolRegistry.find(name);
+        if (!provider) {
+          const packageName = TOOL_PACKAGE_MAP[name] ?? (name.startsWith("@aiready/") ? name : `@aiready/${name}`);
+          try {
+            console.error(
+              `[MCP] Dynamically loading ${packageName} for tool ${name}`
+            );
+            await import(packageName);
+            provider = ToolRegistry.find(name);
+          } catch (importError) {
+            console.error(
+              `[MCP] Failed to load tool package ${packageName}: ${importError.message}`
+            );
+            const error = new Error(
+              `Tool ${name} not found and failed to load package ${packageName}: ${importError.message}`
+            );
+            error.cause = importError;
+            throw error;
+          }
+        }
         if (!provider) {
-          throw new Error(`Tool ${name} not found`);
+          throw new Error(`Tool ${name} not found after attempting to load`);
         }
         if (!args || typeof args.path !== "string") {
           throw new Error("Missing required argument: path");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/mcp-server",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "AIReady Model Context Protocol (MCP) Server",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,10 +13,10 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "chalk": "^5.3.0",
     "zod": "^4.3.6",
-    "@aiready/pattern-detect": "0.16.19",
-    "@aiready/consistency": "0.20.19",
-    "@aiready/core": "0.23.20",
-    "@aiready/context-analyzer": "0.21.23"
+    "@aiready/consistency": "0.20.21",
+    "@aiready/context-analyzer": "0.21.25",
+    "@aiready/core": "0.23.22",
+    "@aiready/pattern-detect": "0.16.21"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/index.ts

@@ -4,14 +4,34 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema,
 } from '@modelcontextprotocol/sdk/types.js';
-import { ToolRegistry } from '@aiready/core';
+import { ToolRegistry, ToolName } from '@aiready/core';
 
-// Pre-load essential tools (following CLI pattern)
-// In a real implementation, we would want to dynamically load these
-// or have them as peer dependencies.
-import '@aiready/pattern-detect';
-import '@aiready/context-analyzer';
-import '@aiready/consistency';
+/**
+ * Mapping between tool names and @aiready/ package names.
+ * Used for dynamic registration on-demand to minimize initial context budget.
+ */
+const TOOL_PACKAGE_MAP: Record<string, string> = {
+  [ToolName.PatternDetect]: '@aiready/pattern-detect',
+  [ToolName.ContextAnalyzer]: '@aiready/context-analyzer',
+  [ToolName.NamingConsistency]: '@aiready/consistency',
+  [ToolName.AiSignalClarity]: '@aiready/ai-signal-clarity',
+  [ToolName.AgentGrounding]: '@aiready/agent-grounding',
+  [ToolName.TestabilityIndex]: '@aiready/testability',
+  [ToolName.DocDrift]: '@aiready/doc-drift',
+  [ToolName.DependencyHealth]: '@aiready/deps',
+  [ToolName.ChangeAmplification]: '@aiready/change-amplification',
+  // Aliases
+  patterns: '@aiready/pattern-detect',
+  duplicates: '@aiready/pattern-detect',
+  context: '@aiready/context-analyzer',
+  fragmentation: '@aiready/context-analyzer',
+  consistency: '@aiready/consistency',
+  'ai-signal': '@aiready/ai-signal-clarity',
+  grounding: '@aiready/agent-grounding',
+  testability: '@aiready/testability',
+  'deps-health': '@aiready/deps',
+  'change-amp': '@aiready/change-amplification',
+};
 
 /**
  * AIReady MCP Server Implementation
@@ -42,12 +62,24 @@ export class AIReadyMcpServer {
   private setupHandlers() {
     // List available tools
     this.server.setRequestHandler(ListToolsRequestSchema, async () => {
-      const providers = ToolRegistry.getAll();
+      // Define canonical tool names to advertise to the client
+      // These will be dynamically loaded on demand
+      const toolsToAdvertise = [
+        ToolName.PatternDetect,
+        ToolName.ContextAnalyzer,
+        ToolName.NamingConsistency,
+        ToolName.AiSignalClarity,
+        ToolName.AgentGrounding,
+        ToolName.TestabilityIndex,
+        ToolName.DocDrift,
+        ToolName.DependencyHealth,
+        ToolName.ChangeAmplification,
+      ];
 
       return {
-        tools: providers.map((p) => ({
-          name: p.id,
-          description: `AIReady analysis tool: ${p.id}`,
+        tools: toolsToAdvertise.map((id) => ({
+          name: id,
+          description: `AIReady analysis tool: ${id}`,
           inputSchema: {
             type: 'object',
             properties: {
@@ -68,9 +100,34 @@ export class AIReadyMcpServer {
       const { name, arguments: args } = request.params;
 
       try {
-        const provider = ToolRegistry.find(name);
+        let provider = ToolRegistry.find(name);
+
+        // Dynamic loading if not already registered (CLI pattern)
+        if (!provider) {
+          const packageName =
+            TOOL_PACKAGE_MAP[name] ??
+            (name.startsWith('@aiready/') ? name : `@aiready/${name}`);
+
+          try {
+            console.error(
+              `[MCP] Dynamically loading ${packageName} for tool ${name}`
+            );
+            await import(packageName);
+            provider = ToolRegistry.find(name);
+          } catch (importError: any) {
+            console.error(
+              `[MCP] Failed to load tool package ${packageName}: ${importError.message}`
+            );
+            const error = new Error(
+              `Tool ${name} not found and failed to load package ${packageName}: ${importError.message}`
+            );
+            (error as any).cause = importError;
+            throw error;
+          }
+        }
+
         if (!provider) {
-          throw new Error(`Tool ${name} not found`);
+          throw new Error(`Tool ${name} not found after attempting to load`);
         }
 
         if (!args || typeof args.path !== 'string') {