@aiready/mcp-server 0.2.8 → 0.2.10

package/.turbo/turbo-build.log

@@ -1,17 +1,16 @@
-
-
-> @aiready/mcp-server@0.2.8 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 7.52 KB
-ESM ⚡️ Build success in 18ms
-DTS Build start
-DTS ⚡️ Build success in 1999ms
-DTS dist/index.d.ts 461.00 B
+
+> @aiready/mcp-server@0.2.8 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 7.52 KB
+ESM ⚡️ Build success in 10ms
+DTS Build start
+DTS ⚡️ Build success in 1358ms
+DTS dist/index.d.ts 461.00 B

package/.turbo/turbo-format-check.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/mcp-server@0.2.8 format-check /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.2.10 format-check /Users/pengcao/projects/aiready/packages/mcp-server
 > prettier --check . --ignore-path ../../.prettierignore
 
 Checking formatting...

package/.turbo/turbo-lint.log

@@ -1,5 +1,5 @@
 
 
-> @aiready/mcp-server@0.2.8 lint /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.2.10 lint /Users/pengcao/projects/aiready/packages/mcp-server
 > eslint src
 

package/.turbo/turbo-type-check.log

@@ -1,5 +1,5 @@
 
 
-> @aiready/mcp-server@0.2.8 type-check /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.2.10 type-check /Users/pengcao/projects/aiready/packages/mcp-server
 > tsc --noEmit
 

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
  */
 declare class AIReadyMcpServer {
     private server;
+    private version;
     constructor();
     private handleRemediation;
     private setupHandlers;

package/dist/index.js

@@ -8,6 +8,15 @@ import {
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { ToolRegistry, ToolName } from "@aiready/core";
+import { z } from "zod";
+var AnalysisArgsSchema = z.object({
+  path: z.string().describe("Path to the directory to analyze")
+});
+var RemediationArgsSchema = z.object({
+  issue_id: z.string().describe("The unique ID of the issue to fix"),
+  file_path: z.string().describe("The path to the file containing the issue"),
+  context: z.string().describe("The content of the file or surrounding code")
+});
 var TOOL_PACKAGE_MAP = {
   [ToolName.PatternDetect]: "@aiready/pattern-detect",
   [ToolName.ContextAnalyzer]: "@aiready/context-analyzer",
@@ -32,10 +41,11 @@ var TOOL_PACKAGE_MAP = {
 };
 var AIReadyMcpServer = class {
   constructor() {
+    this.version = "0.2.10";
     this.server = new Server(
       {
         name: "aiready-server",
-        version: "0.1.0"
+        version: this.version
       },
       {
         capabilities: {
@@ -117,55 +127,61 @@ ${data.rationale}`
         ToolName.DependencyHealth,
         ToolName.ChangeAmplification
       ];
-      return {
-        tools: [
-          ...toolsToAdvertise.map((id) => ({
-            name: id,
-            description: `Scan the directory for ${id} issues to improve AI-readiness.`,
-            inputSchema: {
-              type: "object",
-              properties: {
-                path: {
-                  type: "string",
-                  description: "Path to the directory to analyze"
-                }
+      const tools = [
+        ...toolsToAdvertise.map((id) => ({
+          name: id,
+          description: `Scan the directory for ${id} issues to improve AI-readiness.`,
+          inputSchema: {
+            type: "object",
+            properties: {
+              path: {
+                type: "string",
+                description: "Path to the directory to analyze"
+              }
+            },
+            required: ["path"]
+          }
+        })),
+        {
+          name: "get_remediation_diff",
+          description: "Get a precise code diff to fix a specific AI-readiness issue (Requires AIReady API Key).",
+          inputSchema: {
+            type: "object",
+            properties: {
+              issue_id: {
+                type: "string",
+                description: "The unique ID of the issue to fix (from a scan)."
               },
-              required: ["path"]
-            }
-          })),
-          {
-            name: "get_remediation_diff",
-            description: "Get a precise code diff to fix a specific AI-readiness issue (Requires AIReady API Key).",
-            inputSchema: {
-              type: "object",
-              properties: {
-                issue_id: {
-                  type: "string",
-                  description: "The unique ID of the issue to fix (from a scan)."
-                },
-                file_path: {
-                  type: "string",
-                  description: "The path to the file containing the issue."
-                },
-                context: {
-                  type: "string",
-                  description: "The content of the file or surrounding code."
-                }
+              file_path: {
+                type: "string",
+                description: "The path to the file containing the issue."
               },
-              required: ["issue_id", "file_path", "context"]
-            }
+              context: {
+                type: "string",
+                description: "The content of the file or surrounding code."
+              }
+            },
+            required: ["issue_id", "file_path", "context"]
           }
-        ]
-      };
+        }
+      ];
+      return { tools };
     });
     this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const { name, arguments: args } = request.params;
       try {
         if (name === "get_remediation_diff") {
-          return await this.handleRemediation(
-            args
-          );
+          const parsedArgs2 = RemediationArgsSchema.safeParse(args);
+          if (!parsedArgs2.success) {
+            throw new Error(`Invalid arguments for ${name}: ${parsedArgs2.error.message}`);
+          }
+          return await this.handleRemediation(parsedArgs2.data);
+        }
+        const parsedArgs = AnalysisArgsSchema.safeParse(args);
+        if (!parsedArgs.success) {
+          throw new Error(`Invalid arguments for ${name}: ${parsedArgs.error.message}`);
         }
+        const { path: rootDir } = parsedArgs.data;
         let provider = ToolRegistry.find(name);
         if (!provider) {
           const packageName = TOOL_PACKAGE_MAP[name] ?? (name.startsWith("@aiready/") ? name : `@aiready/${name}`);
@@ -190,12 +206,9 @@ ${data.rationale}`
         if (!provider) {
           throw new Error(`Tool ${name} not found after attempting to load`);
         }
-        if (!args || typeof args.path !== "string") {
-          throw new Error("Missing required argument: path");
-        }
-        console.error(`[MCP] Executing ${name} on ${args.path}`);
+        console.error(`[MCP] Executing ${name} on ${rootDir}`);
         const results = await provider.analyze({
-          rootDir: args.path
+          rootDir
         });
         return {
           content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/mcp-server",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "The AIReady Model Context Protocol (MCP) Server for Agentic Readiness. Optimize codebases for AI agents like Cursor, Windsurf, and Claude directly via MCP.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -13,10 +13,16 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "chalk": "^5.3.0",
     "zod": "^4.3.6",
-    "@aiready/consistency": "0.21.9",
-    "@aiready/core": "0.24.9",
-    "@aiready/context-analyzer": "0.22.9",
-    "@aiready/pattern-detect": "0.17.9"
+    "@aiready/agent-grounding": "0.14.13",
+    "@aiready/ai-signal-clarity": "0.14.15",
+    "@aiready/consistency": "0.21.13",
+    "@aiready/context-analyzer": "0.22.13",
+    "@aiready/core": "0.24.14",
+    "@aiready/pattern-detect": "0.17.13",
+    "@aiready/testability": "0.7.14",
+    "@aiready/doc-drift": "0.14.13",
+    "@aiready/change-amplification": "0.14.13",
+    "@aiready/deps": "0.14.13"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/__tests__/server.test.ts

@@ -104,7 +104,7 @@ describe('AIReady MCP Server Integration', () => {
     expect(typedResult.isError).toBe(true);
     expect(typedResult.content[0].type).toBe('text');
     expect((typedResult.content[0] as any).text).toContain(
-      'Missing required argument: path'
+      'Invalid arguments for pattern-detect'
     );
   });
 });

package/src/index.ts

@@ -5,6 +5,20 @@ import {
   ListToolsRequestSchema,
 } from '@modelcontextprotocol/sdk/types.js';
 import { ToolRegistry, ToolName } from '@aiready/core';
+import { z } from 'zod';
+
+/**
+ * Zod schemas for tool arguments
+ */
+const AnalysisArgsSchema = z.object({
+  path: z.string().describe('Path to the directory to analyze'),
+});
+
+const RemediationArgsSchema = z.object({
+  issue_id: z.string().describe('The unique ID of the issue to fix'),
+  file_path: z.string().describe('The path to the file containing the issue'),
+  context: z.string().describe('The content of the file or surrounding code'),
+});
 
 /**
  * Mapping between tool names and @aiready/ package names.
@@ -38,12 +52,13 @@ const TOOL_PACKAGE_MAP: Record<string, string> = {
  */
 export class AIReadyMcpServer {
   private server: Server;
+  private version: string = '0.2.10';
 
   constructor() {
     this.server = new Server(
       {
         name: 'aiready-server',
-        version: '0.1.0',
+        version: this.version,
       },
       {
         capabilities: {
@@ -59,11 +74,7 @@ export class AIReadyMcpServer {
     };
   }
 
-  private async handleRemediation(args: {
-    issue_id: string;
-    file_path: string;
-    context: string;
-  }) {
+  private async handleRemediation(args: z.infer<typeof RemediationArgsSchema>) {
     const apiKey = process.env.AIREADY_API_KEY;
     const serverUrl =
       process.env.AIREADY_PLATFORM_URL || 'https://platform.getaiready.dev';
@@ -140,48 +151,47 @@ export class AIReadyMcpServer {
         ToolName.ChangeAmplification,
       ];
 
-      return {
-        tools: [
-          ...toolsToAdvertise.map((id) => ({
-            name: id,
-            description: `Scan the directory for ${id} issues to improve AI-readiness.`,
-            inputSchema: {
-              type: 'object',
-              properties: {
-                path: {
-                  type: 'string',
-                  description: 'Path to the directory to analyze',
-                },
+      const tools: any[] = [
+        ...toolsToAdvertise.map((id) => ({
+          name: id,
+          description: `Scan the directory for ${id} issues to improve AI-readiness.`,
+          inputSchema: {
+            type: 'object',
+            properties: {
+              path: {
+                type: 'string',
+                description: 'Path to the directory to analyze',
               },
-              required: ['path'],
             },
-          })),
-          {
-            name: 'get_remediation_diff',
-            description:
-              'Get a precise code diff to fix a specific AI-readiness issue (Requires AIReady API Key).',
-            inputSchema: {
-              type: 'object',
-              properties: {
-                issue_id: {
-                  type: 'string',
-                  description:
-                    'The unique ID of the issue to fix (from a scan).',
-                },
-                file_path: {
-                  type: 'string',
-                  description: 'The path to the file containing the issue.',
-                },
-                context: {
-                  type: 'string',
-                  description: 'The content of the file or surrounding code.',
-                },
+            required: ['path'],
+          },
+        })),
+        {
+          name: 'get_remediation_diff',
+          description:
+            'Get a precise code diff to fix a specific AI-readiness issue (Requires AIReady API Key).',
+          inputSchema: {
+            type: 'object',
+            properties: {
+              issue_id: {
+                type: 'string',
+                description: 'The unique ID of the issue to fix (from a scan).',
+              },
+              file_path: {
+                type: 'string',
+                description: 'The path to the file containing the issue.',
+              },
+              context: {
+                type: 'string',
+                description: 'The content of the file or surrounding code.',
               },
-              required: ['issue_id', 'file_path', 'context'],
             },
+            required: ['issue_id', 'file_path', 'context'],
           },
-        ],
-      };
+        },
+      ];
+
+      return { tools };
     });
 
     // Handle tool execution
@@ -190,14 +200,22 @@ export class AIReadyMcpServer {
 
       try {
         if (name === 'get_remediation_diff') {
-          return await this.handleRemediation(
-            args as {
-              issue_id: string;
-              file_path: string;
-              context: string;
-            }
+          const parsedArgs = RemediationArgsSchema.safeParse(args);
+          if (!parsedArgs.success) {
+            throw new Error(
+              `Invalid arguments for ${name}: ${parsedArgs.error.message}`
+            );
+          }
+          return await this.handleRemediation(parsedArgs.data);
+        }
+
+        const parsedArgs = AnalysisArgsSchema.safeParse(args);
+        if (!parsedArgs.success) {
+          throw new Error(
+            `Invalid arguments for ${name}: ${parsedArgs.error.message}`
           );
         }
+        const { path: rootDir } = parsedArgs.data;
 
         let provider = ToolRegistry.find(name);
 
@@ -233,14 +251,10 @@ export class AIReadyMcpServer {
           throw new Error(`Tool ${name} not found after attempting to load`);
         }
 
-        if (!args || typeof args.path !== 'string') {
-          throw new Error('Missing required argument: path');
-        }
-
-        console.error(`[MCP] Executing ${name} on ${args.path}`);
+        console.error(`[MCP] Executing ${name} on ${rootDir}`);
 
         const results = await provider.analyze({
-          rootDir: args.path,
+          rootDir,
         });
 
         // Format results for the agent