@aiready/mcp-server 0.2.8 → 0.4.0

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/mcp-server@0.2.8 build /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.3.0 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 7.52 KB
-ESM ⚡️ Build success in 18ms
+ESM dist/index.js 8.93 KB
+ESM ⚡️ Build success in 42ms
 DTS Build start
-DTS ⚡️ Build success in 1999ms
-DTS dist/index.d.ts 461.00 B
+DTS ⚡️ Build success in 4156ms
+DTS dist/index.d.ts 482.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.3.0 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.3.0 lint /Users/pengcao/projects/aiready/packages/mcp-server
 > eslint src
 

package/.turbo/turbo-test.log

@@ -1,22 +1,20 @@
-
-
-> @aiready/mcp-server@0.2.7 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
-[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) 902ms
-     ✓ should execute pattern-detect and return results  472ms
-
- Test Files  1 passed (1)
-      Tests  5 passed (5)
-   Start at  00:14:12
-   Duration  1.20s (transform 68ms, setup 0ms, import 112ms, tests 902ms, environment 0ms)
-
-[?25h
+
+> @aiready/mcp-server@0.2.10 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) 1147ms
+     ✓ should execute pattern-detect and return results  783ms
+
+ Test Files  1 passed (1)
+      Tests  5 passed (5)
+   Start at  14:45:23
+   Duration  1.44s (transform 45ms, setup 0ms, import 89ms, tests 1.15s, environment 0ms)
+

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.3.0 type-check /Users/pengcao/projects/aiready/packages/mcp-server
 > tsc --noEmit
 

package/README.md

@@ -48,7 +48,7 @@ To use the AIReady MCP server in the Claude Desktop app, add the following confi
 If you prefer running MCP servers in isolated environments, you can use our Docker image:
 
 ```bash
-docker run -i --rm ghcr.io/caopengau/aiready-mcp-server
+docker run -i --rm ghcr.io/getaiready/aiready-mcp-server
 ```
 
 _(Note: Docker image distribution is currently being set up. Use the command above once published.)_

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,18 @@ 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"),
+  summary_only: z.boolean().optional().describe(
+    "If true, returns only the summary and skips the detailed issue list. Best for large projects to save context."
+  )
+});
+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 +44,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 +130,69 @@ ${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)."
-                },
-                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."
-                }
+              summary_only: {
+                type: "boolean",
+                description: "If true, returns only the summary and skips the detailed issue list. Best for large projects to save context."
+              }
+            },
+            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: ["issue_id", "file_path", "context"]
-            }
+              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"]
           }
-        ]
-      };
+        }
+      ];
+      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, summary_only } = parsedArgs.data;
         let provider = ToolRegistry.find(name);
         if (!provider) {
           const packageName = TOOL_PACKAGE_MAP[name] ?? (name.startsWith("@aiready/") ? name : `@aiready/${name}`);
@@ -190,18 +217,22 @@ ${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}${summary_only ? " (summary only)" : ""}`
+        );
         const results = await provider.analyze({
-          rootDir: args.path
+          rootDir
         });
+        const responseData = summary_only ? {
+          summary: results.summary,
+          metadata: results.metadata,
+          notice: "Detailed issues were omitted (summary_only: true). Run without summary_only for full details."
+        } : results;
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(results, null, 2)
+              text: JSON.stringify(responseData, null, 2)
             }
           ]
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/mcp-server",
-  "version": "0.2.8",
+  "version": "0.4.0",
   "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.15",
+    "@aiready/ai-signal-clarity": "0.14.17",
+    "@aiready/change-amplification": "0.14.15",
+    "@aiready/context-analyzer": "0.22.15",
+    "@aiready/consistency": "0.21.15",
+    "@aiready/core": "0.24.16",
+    "@aiready/deps": "0.14.15",
+    "@aiready/doc-drift": "0.14.15",
+    "@aiready/testability": "0.7.16",
+    "@aiready/pattern-detect": "0.17.15"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",

package/src/__tests__/server.test.ts

@@ -47,7 +47,7 @@ describe('AIReady MCP Server Integration', () => {
     expect(toolNames).toContain('naming-consistency');
   });
 
-  it('should expose correct input schema for tools', async () => {
+  it('should expose correct input schema for tools including summary_only', async () => {
     const result = await client.listTools();
 
     const patternDetect = result.tools.find((t) => t.name === 'pattern-detect');
@@ -55,11 +55,31 @@ describe('AIReady MCP Server Integration', () => {
       type: 'object',
       properties: {
         path: { type: 'string' },
+        summary_only: { type: 'boolean' },
       },
       required: ['path'],
     });
   });
 
+  it('should execute pattern-detect with summary_only: true and return only summary', async () => {
+    const result = await client.callTool({
+      name: 'pattern-detect',
+      arguments: {
+        path: path.resolve(__dirname, '../../../core'),
+        summary_only: true,
+      },
+    });
+    const typedResult = result as ToolCallResponse;
+
+    expect(typedResult.content).toBeDefined();
+    const data = JSON.parse((typedResult.content[0] as any).text);
+
+    expect(data).toHaveProperty('summary');
+    expect(data).toHaveProperty('metadata');
+    expect(data).toHaveProperty('notice');
+    expect(data).not.toHaveProperty('results');
+  }, 20000);
+
   it('should execute pattern-detect and return results', async () => {
     const result = await client.callTool({
       name: 'pattern-detect',
@@ -104,7 +124,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,26 @@ 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'),
+  summary_only: z
+    .boolean()
+    .optional()
+    .describe(
+      'If true, returns only the summary and skips the detailed issue list. Best for large projects to save context.'
+    ),
+});
+
+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 +58,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 +80,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 +157,52 @@ 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',
+              },
+              summary_only: {
+                type: 'boolean',
+                description:
+                  'If true, returns only the summary and skips the detailed issue list. Best for large projects to save context.',
               },
-              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 +211,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, summary_only } = parsedArgs.data;
 
         let provider = ToolRegistry.find(name);
 
@@ -233,22 +262,31 @@ 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}${
+            summary_only ? ' (summary only)' : ''
+          }`
+        );
 
         const results = await provider.analyze({
-          rootDir: args.path,
+          rootDir,
         });
 
         // Format results for the agent
+        const responseData = summary_only
+          ? {
+              summary: results.summary,
+              metadata: results.metadata,
+              notice:
+                'Detailed issues were omitted (summary_only: true). Run without summary_only for full details.',
+            }
+          : results;
+
         return {
           content: [
             {
               type: 'text',
-              text: JSON.stringify(results, null, 2),
+              text: JSON.stringify(responseData, null, 2),
             },
           ],
         };