@aiready/mcp-server 0.1.18 → 0.1.19

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/mcp-server@0.1.18 build /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.1.19 build /Users/pengcao/projects/aiready/packages/mcp-server
 > tsup src/index.ts --format esm --clean --dts
 
 CLI Building entry: src/index.ts
@@ -10,8 +10,8 @@
 CLI Target: node20
 CLI Cleaning output folder
 ESM Build start
-ESM dist/index.js 2.90 KB
-ESM ⚡️ Build success in 18ms
+ESM dist/index.js 4.81 KB
+ESM ⚡️ Build success in 82ms
 DTS Build start
-DTS ⚡️ Build success in 1451ms
+DTS ⚡️ Build success in 5011ms
 DTS dist/index.d.ts 430.00 B

package/.turbo/turbo-test.log

@@ -1,19 +1,22 @@
 
 
-> @aiready/mcp-server@0.1.17 test /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.1.18 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] Dynamically loading @aiready/pattern-detect for tool pattern-detect
 [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
+[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) 2991ms
+     ✓ should execute pattern-detect and return results  1587ms
 
  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)
+   Start at  23:31:26
+   Duration  3.55s (transform 98ms, setup 0ms, import 157ms, tests 2.99s, environment 0ms)
 
 [?25h

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.19",
   "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.20",
+    "@aiready/context-analyzer": "0.21.24",
+    "@aiready/core": "0.23.21",
+    "@aiready/pattern-detect": "0.16.20"
   },
   "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') {