@aiready/mcp-server 0.2.5 → 0.2.7

package/.turbo/turbo-build.log

@@ -1,16 +1,17 @@
-
-> @aiready/mcp-server@0.2.5 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 26ms
-DTS Build start
-DTS ⚡️ Build success in 3004ms
-DTS dist/index.d.ts 430.00 B
+
+
+> @aiready/mcp-server@0.2.7 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 17ms
+DTS Build start
+DTS ⚡️ Build success in 950ms
+DTS dist/index.d.ts 461.00 B

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

@@ -0,0 +1,7 @@
+
+
+> @aiready/mcp-server@0.2.7 format-check /Users/pengcao/projects/aiready/packages/mcp-server
+> prettier --check . --ignore-path ../../.prettierignore
+
+Checking formatting...
+.env.smithery.well-known/mcp/server-card.jsonpackage.jsonREADME.mdsmithery.yamlsrc/__tests__/server.test.tssrc/index.tstest-mcp.tstsconfig.jsontsup.config.tsAll matched files use Prettier code style!

package/.turbo/turbo-lint.log

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

package/.turbo/turbo-test.log

@@ -1,8 +1,22 @@
-
-> @aiready/mcp-server@0.2.4 test /Users/pengcao/projects/aiready/packages/mcp-server
-> vitest run
-
-
- RUN  v4.0.18 /Users/pengcao/projects/aiready/packages/mcp-server
-
- ELIFECYCLE  Test failed. See above for more details.
+
+
+> @aiready/mcp-server@0.2.6 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) 622ms
+     ✓ should execute pattern-detect and return results  351ms
+
+ Test Files  1 passed (1)
+      Tests  5 passed (5)
+   Start at  00:08:39
+   Duration  747ms (transform 23ms, setup 0ms, import 41ms, tests 622ms, environment 0ms)
+
+[?25h

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

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

package/dist/index.d.ts

@@ -6,6 +6,7 @@ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 declare class AIReadyMcpServer {
     private server;
     constructor();
+    private handleRemediation;
     private setupHandlers;
     run(): Promise<void>;
     getServer(): Server;

package/dist/index.js

@@ -48,6 +48,62 @@ var AIReadyMcpServer = class {
       console.error("[MCP Error]", error);
     };
   }
+  async handleRemediation(args) {
+    const apiKey = process.env.AIREADY_API_KEY;
+    const serverUrl = process.env.AIREADY_PLATFORM_URL || "https://platform.getaiready.dev";
+    if (!apiKey) {
+      throw new Error(
+        "AIREADY_API_KEY is not set. Remediation requires an active subscription."
+      );
+    }
+    console.error(`[MCP] Requesting remediation for ${args.issue_id}...`);
+    try {
+      const response = await fetch(`${serverUrl}/api/v1/remediate`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-API-KEY": apiKey
+        },
+        body: JSON.stringify({
+          issueId: args.issue_id,
+          filePath: args.file_path,
+          context: args.context,
+          agent: "mcp-server"
+        })
+      });
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(
+          `Platform Error: ${errorData.message || response.statusText}`
+        );
+      }
+      const data = await response.json();
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Recommended Fix (Diff):
+
+${data.diff}
+
+Rationale:
+${data.rationale}`
+          }
+        ]
+      };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Failed to get remediation: ${errorMessage}. Please visit the dashboard to fix manually.`
+          }
+        ],
+        isError: true
+      };
+    }
+  }
   setupHandlers() {
     this.server.setRequestHandler(ListToolsRequestSchema, async () => {
       const toolsToAdvertise = [
@@ -62,26 +118,54 @@ var AIReadyMcpServer = class {
         ToolName.ChangeAmplification
       ];
       return {
-        tools: toolsToAdvertise.map((id) => ({
-          name: id,
-          description: `AIReady analysis tool: ${id}`,
-          inputSchema: {
-            type: "object",
-            properties: {
-              path: {
-                type: "string",
-                description: "Path to the directory to analyze"
-              }
-              // Future: expose tool-specific options
-            },
-            required: ["path"]
+        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."
+                }
+              },
+              required: ["issue_id", "file_path", "context"]
+            }
           }
-        }))
+        ]
       };
     });
     this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const { name, arguments: args } = request.params;
       try {
+        if (name === "get_remediation_diff") {
+          return await this.handleRemediation(
+            args
+          );
+        }
         let provider = ToolRegistry.find(name);
         if (!provider) {
           const packageName = TOOL_PACKAGE_MAP[name] ?? (name.startsWith("@aiready/") ? name : `@aiready/${name}`);
@@ -92,11 +176,12 @@ var AIReadyMcpServer = class {
             await import(packageName);
             provider = ToolRegistry.find(name);
           } catch (importError) {
+            const importErrorMessage = importError instanceof Error ? importError.message : String(importError);
             console.error(
-              `[MCP] Failed to load tool package ${packageName}: ${importError.message}`
+              `[MCP] Failed to load tool package ${packageName}: ${importErrorMessage}`
             );
             const error = new Error(
-              `Tool ${name} not found and failed to load package ${packageName}: ${importError.message}`
+              `Tool ${name} not found and failed to load package ${packageName}: ${importErrorMessage}`
             );
             error.cause = importError;
             throw error;
@@ -121,11 +206,12 @@ var AIReadyMcpServer = class {
           ]
         };
       } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
         return {
           content: [
             {
               type: "text",
-              text: `Error: ${error.message}`
+              text: `Error: ${errorMessage}`
             }
           ],
           isError: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiready/mcp-server",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "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,10 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "chalk": "^5.3.0",
     "zod": "^4.3.6",
-    "@aiready/consistency": "0.21.6",
-    "@aiready/context-analyzer": "0.22.6",
-    "@aiready/core": "0.24.6",
-    "@aiready/pattern-detect": "0.17.6"
+    "@aiready/consistency": "0.21.8",
+    "@aiready/pattern-detect": "0.17.8",
+    "@aiready/context-analyzer": "0.22.8",
+    "@aiready/core": "0.24.8"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
@@ -47,6 +47,8 @@
     "test": "vitest run",
     "lint": "eslint src",
     "clean": "rm -rf dist",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "type-check": "tsc --noEmit",
+    "format-check": "prettier --check . --ignore-path ../../.prettierignore"
   }
 }

package/src/index.ts

@@ -59,6 +59,70 @@ export class AIReadyMcpServer {
     };
   }
 
+  private async handleRemediation(args: {
+    issue_id: string;
+    file_path: string;
+    context: string;
+  }) {
+    const apiKey = process.env.AIREADY_API_KEY;
+    const serverUrl =
+      process.env.AIREADY_PLATFORM_URL || 'https://platform.getaiready.dev';
+
+    if (!apiKey) {
+      throw new Error(
+        'AIREADY_API_KEY is not set. Remediation requires an active subscription.'
+      );
+    }
+
+    console.error(`[MCP] Requesting remediation for ${args.issue_id}...`);
+
+    try {
+      const response = await fetch(`${serverUrl}/api/v1/remediate`, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-API-KEY': apiKey,
+        },
+        body: JSON.stringify({
+          issueId: args.issue_id,
+          filePath: args.file_path,
+          context: args.context,
+          agent: 'mcp-server',
+        }),
+      });
+
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw new Error(
+          `Platform Error: ${errorData.message || response.statusText}`
+        );
+      }
+
+      const data = await response.json();
+
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Recommended Fix (Diff):\n\n${data.diff}\n\nRationale:\n${data.rationale}`,
+          },
+        ],
+      };
+    } catch (error: unknown) {
+      const errorMessage =
+        error instanceof Error ? error.message : String(error);
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Failed to get remediation: ${errorMessage}. Please visit the dashboard to fix manually.`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  }
+
   private setupHandlers() {
     // List available tools
     this.server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -77,21 +141,46 @@ export class AIReadyMcpServer {
       ];
 
       return {
-        tools: toolsToAdvertise.map((id) => ({
-          name: id,
-          description: `AIReady analysis tool: ${id}`,
-          inputSchema: {
-            type: 'object',
-            properties: {
-              path: {
-                type: 'string',
-                description: 'Path to the directory to analyze',
+        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.',
+                },
               },
-              // Future: expose tool-specific options
+              required: ['issue_id', 'file_path', 'context'],
             },
-            required: ['path'],
           },
-        })),
+        ],
       };
     });
 
@@ -100,6 +189,16 @@ export class AIReadyMcpServer {
       const { name, arguments: args } = request.params;
 
       try {
+        if (name === 'get_remediation_diff') {
+          return await this.handleRemediation(
+            args as {
+              issue_id: string;
+              file_path: string;
+              context: string;
+            }
+          );
+        }
+
         let provider = ToolRegistry.find(name);
 
         // Dynamic loading if not already registered (CLI pattern)
@@ -114,12 +213,16 @@ export class AIReadyMcpServer {
             );
             await import(packageName);
             provider = ToolRegistry.find(name);
-          } catch (importError: any) {
+          } catch (importError: unknown) {
+            const importErrorMessage =
+              importError instanceof Error
+                ? importError.message
+                : String(importError);
             console.error(
-              `[MCP] Failed to load tool package ${packageName}: ${importError.message}`
+              `[MCP] Failed to load tool package ${packageName}: ${importErrorMessage}`
             );
             const error = new Error(
-              `Tool ${name} not found and failed to load package ${packageName}: ${importError.message}`
+              `Tool ${name} not found and failed to load package ${packageName}: ${importErrorMessage}`
             );
             (error as { cause?: unknown }).cause = importError;
             throw error;
@@ -149,12 +252,14 @@ export class AIReadyMcpServer {
             },
           ],
         };
-      } catch (error: any) {
+      } catch (error: unknown) {
+        const errorMessage =
+          error instanceof Error ? error.message : String(error);
         return {
           content: [
             {
               type: 'text',
-              text: `Error: ${error.message}`,
+              text: `Error: ${errorMessage}`,
             },
           ],
           isError: true,