@aiready/mcp-server 0.2.10 → 0.5.0

package/.turbo/turbo-build.log

@@ -1,16 +1,17 @@
-
-> @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
+
+
+> @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
+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 8.93 KB
+ESM ⚡️ Build success in 42ms
+DTS Build start
+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.10 format-check /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.4.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.10 lint /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.4.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.10 type-check /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.4.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.js

@@ -10,7 +10,10 @@ import {
 import { ToolRegistry, ToolName } from "@aiready/core";
 import { z } from "zod";
 var AnalysisArgsSchema = z.object({
-  path: z.string().describe("Path to the directory to analyze")
+  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"),
@@ -137,6 +140,10 @@ ${data.rationale}`
               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"]
@@ -173,15 +180,19 @@ ${data.rationale}`
         if (name === "get_remediation_diff") {
           const parsedArgs2 = RemediationArgsSchema.safeParse(args);
           if (!parsedArgs2.success) {
-            throw new Error(`Invalid arguments for ${name}: ${parsedArgs2.error.message}`);
+            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}`);
+          throw new Error(
+            `Invalid arguments for ${name}: ${parsedArgs.error.message}`
+          );
         }
-        const { path: rootDir } = parsedArgs.data;
+        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}`);
@@ -206,15 +217,22 @@ ${data.rationale}`
         if (!provider) {
           throw new Error(`Tool ${name} not found after attempting to load`);
         }
-        console.error(`[MCP] Executing ${name} on ${rootDir}`);
+        console.error(
+          `[MCP] Executing ${name} on ${rootDir}${summary_only ? " (summary only)" : ""}`
+        );
         const results = await provider.analyze({
           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.10",
+  "version": "0.5.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,16 +13,16 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "chalk": "^5.3.0",
     "zod": "^4.3.6",
-    "@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"
+    "@aiready/agent-grounding": "0.14.15",
+    "@aiready/ai-signal-clarity": "0.14.17",
+    "@aiready/consistency": "0.21.15",
+    "@aiready/core": "0.24.16",
+    "@aiready/deps": "0.14.15",
+    "@aiready/change-amplification": "0.14.15",
+    "@aiready/context-analyzer": "0.22.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',

package/src/index.ts

@@ -12,6 +12,12 @@ import { z } from 'zod';
  */
 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({
@@ -162,6 +168,11 @@ export class AIReadyMcpServer {
                 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'],
           },
@@ -215,7 +226,7 @@ export class AIReadyMcpServer {
             `Invalid arguments for ${name}: ${parsedArgs.error.message}`
           );
         }
-        const { path: rootDir } = parsedArgs.data;
+        const { path: rootDir, summary_only } = parsedArgs.data;
 
         let provider = ToolRegistry.find(name);
 
@@ -251,18 +262,31 @@ export class AIReadyMcpServer {
           throw new Error(`Tool ${name} not found after attempting to load`);
         }
 
-        console.error(`[MCP] Executing ${name} on ${rootDir}`);
+        console.error(
+          `[MCP] Executing ${name} on ${rootDir}${
+            summary_only ? ' (summary only)' : ''
+          }`
+        );
 
         const results = await provider.analyze({
           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),
             },
           ],
         };