@aiready/mcp-server 0.1.0 → 0.1.2

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 
 
-> @aiready/mcp-server@0.1.0 build /Users/pengcao/projects/aiready/packages/mcp-server
+> @aiready/mcp-server@0.1.2 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.74 KB
-ESM ⚡️ Build success in 29ms
+ESM dist/index.js 2.90 KB
+ESM ⚡️ Build success in 31ms
 DTS Build start
-DTS ⚡️ Build success in 2555ms
-DTS dist/index.d.ts 202.00 B
+DTS ⚡️ Build success in 1016ms
+DTS dist/index.d.ts 430.00 B

package/.turbo/turbo-lint.log

@@ -0,0 +1,10 @@
+
+> @aiready/mcp-server@0.1.0 lint /Users/pengcao/projects/aiready/packages/mcp-server
+> eslint src
+
+
+/Users/pengcao/projects/aiready/packages/mcp-server/src/index.ts
+  7:24  warning  'ToolName' is defined but never used  @typescript-eslint/no-unused-vars
+
+✖ 1 problem (0 errors, 1 warning)
+

package/.turbo/turbo-test.log

@@ -0,0 +1,18 @@
+
+
+> @aiready/mcp-server@0.1.1 test /Users/pengcao/projects/aiready/packages/mcp-server
+> vitest run
+
+
+ RUN  v2.1.9 /Users/pengcao/projects/aiready/packages/mcp-server
+
+AIReady MCP Server started
+[MCP] Executing pattern-detect on /Users/pengcao/projects/aiready/packages/core
+ ✓ src/__tests__/server.test.ts (5 tests) 663ms
+
+ Test Files  1 passed (1)
+      Tests  5 passed (5)
+   Start at  22:22:09
+   Duration  1.17s (transform 73ms, setup 0ms, collect 81ms, tests 663ms, environment 0ms, prepare 116ms)
+
+[?25h

package/.well-known/mcp/server-card.json

@@ -0,0 +1,55 @@
+{
+  "serverInfo": {
+    "name": "AIReady MCP Server",
+    "version": "0.1.0"
+  },
+  "authentication": {
+    "required": false
+  },
+  "tools": [
+    {
+      "name": "pattern-detect",
+      "description": "AIReady analysis tool: pattern-detect",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Path to the directory to analyze"
+          }
+        },
+        "required": ["path"]
+      }
+    },
+    {
+      "name": "context-analyzer",
+      "description": "AIReady analysis tool: context-analyzer",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Path to the directory to analyze"
+          }
+        },
+        "required": ["path"]
+      }
+    },
+    {
+      "name": "consistency",
+      "description": "AIReady analysis tool: consistency",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Path to the directory to analyze"
+          }
+        },
+        "required": ["path"]
+      }
+    }
+  ],
+  "resources": [],
+  "prompts": []
+}

package/README.md

@@ -0,0 +1,71 @@
+# AIReady MCP Server
+
+The AIReady MCP Server provides an integration point for AI agents (like Claude Desktop, Cursor, Windsurf, etc.) to assess AI-readiness and improve AI leverage directly within their conversational interfaces using the Model Context Protocol (MCP).
+
+## Installation & Distribution Channels
+
+You can install and use the AIReady MCP server through several supported channels.
+
+### 1. Dedicated MCP Registries
+
+- **[Smithery](https://smithery.ai)**: Discover and install our server directly via the Smithery CLI:
+  ```bash
+  npx @smithery/cli install @aiready/mcp-server
+  ```
+- **[Glama](https://glama.ai/mcp)**: View our listing and integration options on the Glama directory.
+- **[Pulsar](https://gotopulsar.com)**: Find us on the Pulsar registry for MCP servers.
+
+### 2. Direct IDE / Assistant Integrations
+
+#### Claude Desktop App
+
+To use the AIReady MCP server in the Claude Desktop app, add the following configuration to your `claude_desktop_config.json`:
+
+```json
+"mcpServers": {
+  "aiready": {
+    "command": "npx",
+    "args": ["-y", "@aiready/mcp-server"]
+  }
+}
+```
+
+#### Cursor IDE
+
+1. Open Cursor Settings.
+2. Navigate to **Features** -> **MCP Servers**.
+3. Add a new server.
+4. Set the command to: `npx -y @aiready/mcp-server`
+
+#### Windsurf IDE
+
+1. Open Windsurf Settings or local environment configuration.
+2. Add a new MCP Server integration.
+3. Configure the execution command: `npx -y @aiready/mcp-server`
+
+### 3. Containerized Distribution (Docker)
+
+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
+```
+
+_(Note: Docker image distribution is currently being set up. Use the command above once published.)_
+
+### 4. Existing AIReady Channels
+
+We are also integrating the MCP server with our existing distribution methods:
+
+- **Homebrew**: `brew install aiready-mcp` (Coming soon)
+- **VS Code Extension**: Bundled within the AIReady extension for editor-native AI chats. (Coming soon)
+
+## Quick Start
+
+To test the server locally, you can run:
+
+```bash
+npx @aiready/mcp-server
+```
+
+For more details on AIReady, visit [getaiready.dev](https://getaiready.dev).

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+
 /**
  * AIReady MCP Server Implementation
  */
@@ -6,6 +8,9 @@ declare class AIReadyMcpServer {
     constructor();
     private setupHandlers;
     run(): Promise<void>;
+    getServer(): Server;
 }
+declare function createSandboxServer(): Server;
+declare const mcpServer: AIReadyMcpServer;
 
-export { AIReadyMcpServer };
+export { AIReadyMcpServer, createSandboxServer, mcpServer as default };

package/dist/index.js

@@ -8,7 +8,6 @@ import {
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
 import { ToolRegistry } from "@aiready/core";
-import chalk from "chalk";
 import "@aiready/pattern-detect";
 import "@aiready/context-analyzer";
 import "@aiready/consistency";
@@ -27,7 +26,7 @@ var AIReadyMcpServer = class {
     );
     this.setupHandlers();
     this.server.onerror = (error) => {
-      console.error(chalk.red("[MCP Error]"), error);
+      console.error("[MCP Error]", error);
     };
   }
   setupHandlers() {
@@ -61,7 +60,7 @@ var AIReadyMcpServer = class {
         if (!args || typeof args.path !== "string") {
           throw new Error("Missing required argument: path");
         }
-        console.error(chalk.blue(`[MCP] Executing ${name} on ${args.path}`));
+        console.error(`[MCP] Executing ${name} on ${args.path}`);
         const results = await provider.analyze({
           rootDir: args.path
         });
@@ -89,14 +88,24 @@ var AIReadyMcpServer = class {
   async run() {
     const transport = new StdioServerTransport();
     await this.server.connect(transport);
-    console.error(chalk.green("AIReady MCP Server started"));
+    console.error("AIReady MCP Server started");
+  }
+  getServer() {
+    return this.server;
   }
 };
-var server = new AIReadyMcpServer();
-server.run().catch((error) => {
-  console.error(chalk.red("Fatal error starting AIReady MCP Server:"), error);
+function createSandboxServer() {
+  const mcp = new AIReadyMcpServer();
+  return mcp.getServer();
+}
+var mcpServer = new AIReadyMcpServer();
+mcpServer.run().catch((error) => {
+  console.error("Fatal error starting AIReady MCP Server:", error);
   process.exit(1);
 });
+var index_default = mcpServer;
 export {
-  AIReadyMcpServer
+  AIReadyMcpServer,
+  createSandboxServer,
+  index_default as default
 };

package/package.json

@@ -1,25 +1,26 @@
 {
   "name": "@aiready/mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "AIReady Model Context Protocol (MCP) Server",
   "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "type": "module",
   "bin": {
-    "aiready-mcp": "./dist/index.js"
+    "aiready-mcp": "./dist/index.js",
+    "mcp-server": "./dist/index.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^0.6.0",
     "chalk": "^5.3.0",
     "zod": "^4.3.6",
-    "@aiready/core": "0.23.2",
-    "@aiready/context-analyzer": "0.21.6",
-    "@aiready/consistency": "0.20.2",
-    "@aiready/pattern-detect": "0.16.2"
+    "@aiready/consistency": "0.20.3",
+    "@aiready/context-analyzer": "0.21.7",
+    "@aiready/core": "0.23.3",
+    "@aiready/pattern-detect": "0.16.3"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
+    "esbuild": "^0.27.3",
     "tsup": "^8.3.5",
     "typescript": "^5.9.3",
     "vitest": "^2.1.0"

package/smithery.yaml

@@ -0,0 +1,7 @@
+startCommand:
+  type: stdio
+  config:
+    command: npx
+    args:
+      - -y
+      - '@aiready/mcp-server'

package/src/__tests__/server.test.ts

@@ -1,10 +1,6 @@
 import { describe, it, expect, beforeAll, afterAll } from 'vitest';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-import {
-  ListToolsRequestSchema,
-  CallToolRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js';
 import path from 'path';
 import { fileURLToPath } from 'url';
 
@@ -12,6 +8,11 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // Point to the built JS to ensure we are testing the actual distribution
 const serverPath = path.resolve(__dirname, '../../dist/index.js');
 
+type ToolCallResponse = {
+  content: Array<{ type: string; text: string }>;
+  isError?: boolean;
+};
+
 describe('AIReady MCP Server Integration', () => {
   let client: Client;
   let transport: StdioClientTransport;
@@ -66,11 +67,12 @@ describe('AIReady MCP Server Integration', () => {
         path: path.resolve(__dirname, '../../../core'), // Test on core package
       },
     });
+    const typedResult = result as ToolCallResponse;
 
     // Check if result has content
-    expect(result.content).toBeDefined();
+    expect(typedResult.content).toBeDefined();
 
-    const firstContent = result.content[0];
+    const firstContent = typedResult.content[0];
     expect(firstContent.type).toBe('text');
 
     const data = JSON.parse((firstContent as any).text);
@@ -83,9 +85,10 @@ describe('AIReady MCP Server Integration', () => {
       name: 'non-existent-tool',
       arguments: { path: '.' },
     });
+    const typedResult = result as ToolCallResponse;
 
-    expect(result.isError).toBe(true);
-    expect((result.content[0] as any).text).toContain(
+    expect(typedResult.isError).toBe(true);
+    expect((typedResult.content[0] as any).text).toContain(
       'Tool non-existent-tool not found'
     );
   });
@@ -96,10 +99,11 @@ describe('AIReady MCP Server Integration', () => {
       name: 'pattern-detect',
       arguments: {},
     });
+    const typedResult = result as ToolCallResponse;
 
-    expect(result.isError).toBe(true);
-    expect(result.content[0].type).toBe('text');
-    expect((result.content[0] as any).text).toContain(
+    expect(typedResult.isError).toBe(true);
+    expect(typedResult.content[0].type).toBe('text');
+    expect((typedResult.content[0] as any).text).toContain(
       'Missing required argument: path'
     );
   });

package/src/index.ts

@@ -4,8 +4,7 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema,
 } from '@modelcontextprotocol/sdk/types.js';
-import { ToolRegistry, ToolName } from '@aiready/core';
-import chalk from 'chalk';
+import { ToolRegistry } from '@aiready/core';
 
 // Pre-load essential tools (following CLI pattern)
 // In a real implementation, we would want to dynamically load these
@@ -36,7 +35,7 @@ export class AIReadyMcpServer {
     this.setupHandlers();
 
     this.server.onerror = (error) => {
-      console.error(chalk.red('[MCP Error]'), error);
+      console.error('[MCP Error]', error);
     };
   }
 
@@ -78,7 +77,7 @@ export class AIReadyMcpServer {
           throw new Error('Missing required argument: path');
         }
 
-        console.error(chalk.blue(`[MCP] Executing ${name} on ${args.path}`));
+        console.error(`[MCP] Executing ${name} on ${args.path}`);
 
         const results = await provider.analyze({
           rootDir: args.path,
@@ -110,13 +109,24 @@ export class AIReadyMcpServer {
   async run() {
     const transport = new StdioServerTransport();
     await this.server.connect(transport);
-    console.error(chalk.green('AIReady MCP Server started'));
+    console.error('AIReady MCP Server started');
+  }
+
+  getServer(): Server {
+    return this.server;
   }
 }
 
+export function createSandboxServer(): Server {
+  const mcp = new AIReadyMcpServer();
+  return mcp.getServer();
+}
+
 // Bootstrap the server
-const server = new AIReadyMcpServer();
-server.run().catch((error) => {
-  console.error(chalk.red('Fatal error starting AIReady MCP Server:'), error);
+const mcpServer = new AIReadyMcpServer();
+mcpServer.run().catch((error) => {
+  console.error('Fatal error starting AIReady MCP Server:', error);
   process.exit(1);
 });
+
+export default mcpServer;

package/test-mcp.ts

@@ -1,15 +1,20 @@
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-import {
-  ListToolsRequestSchema,
-  CallToolRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js';
 import path from 'path';
 import { fileURLToPath } from 'url';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const serverPath = path.join(__dirname, 'dist', 'index.js');
 
+type ListToolsResponse = {
+  tools: Array<{ name: string }>;
+};
+
+type ToolCallResponse = {
+  isError?: boolean;
+  content?: Array<{ type: string; text: string }>;
+};
+
 async function testServer() {
   console.log('🚀 Starting MCP Server verification test...');
 
@@ -37,10 +42,7 @@ async function testServer() {
     console.log('✅ Connected to MCP Server');
 
     // Test ListTools
-    const tools = await client.request(
-      { method: 'tools/list' },
-      ListToolsRequestSchema
-    );
+    const tools = (await client.listTools()) as ListToolsResponse;
     console.log(
       '📋 Available Tools:',
       tools.tools.map((t) => t.name).join(', ')
@@ -53,25 +55,24 @@ async function testServer() {
     // Test CallTool (pattern-detect)
     console.log("🔍 Testing 'pattern-detect'...");
     const rootDir = '/Users/pengcao/projects/aiready'; // Test on current repo
-    const result = await client.request(
-      {
-        method: 'tools/call',
-        params: {
-          name: 'pattern-detect',
-          arguments: { path: rootDir },
-        },
-      },
-      CallToolRequestSchema
-    );
+    const result = (await client.callTool({
+      name: 'pattern-detect',
+      arguments: { path: rootDir },
+    })) as ToolCallResponse;
 
     if (result.isError) {
-      console.error('❌ Tool execution failed:', result.content[0].text);
-    } else {
+      console.error(
+        '❌ Tool execution failed:',
+        result.content?.[0]?.text || 'Unknown MCP error'
+      );
+    } else if (result.content?.[0]?.text) {
       console.log('✅ Tool execution success!');
       const data = JSON.parse(result.content[0].text);
       console.log(
         `📊 Found ${data.duplicates?.length || 0} duplicate patterns.`
       );
+    } else {
+      throw new Error('Tool call returned no content');
     }
   } catch (error) {
     console.error('💥 Test failed:', error);