@mkrlbs/mcp-adonisjs 0.1.0

package/README.md

@@ -0,0 +1,139 @@
+# AdonisJS MCP Server
+
+A secure [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for executing AdonisJS Ace commands. This server allows AI assistants to interact with AdonisJS projects through a controlled, secure interface.
+
+## Features
+
+- 🔒 **Secure by default**: Blacklists dangerous commands and prevents shell injection
+- 🛠️ **Multiple tools**: Pre-configured tools for common AdonisJS operations
+- ✅ **Validation**: Strict argument validation using Zod schemas
+- 📦 **TypeScript**: Fully typed with TypeScript for better DX
+
+## Installation
+
+```bash
+npm install @mkrlbs/mcp-adonisjs
+```
+
+## Available Tools
+
+### 1. `make_controller`
+
+Creates an AdonisJS controller using `node ace make:controller`.
+
+**Arguments:**
+- `name` (string, required): Name of the controller to create
+- `resource` (boolean, optional): Whether to create a resource controller (default: false)
+
+**Example:**
+```json
+{
+  "name": "UserController",
+  "resource": true
+}
+```
+
+### 2. `make_service`
+
+Creates an AdonisJS service using `node ace make:service`.
+
+**Arguments:**
+- `name` (string, required): Name of the service to create
+
+**Example:**
+```json
+{
+  "name": "AuthService"
+}
+```
+
+### 3. `run_ace_command`
+
+Executes any AdonisJS Ace command with security checks.
+
+**Arguments:**
+- `command` (string, required): The Ace command to run (e.g., 'make:model')
+- `args` (array of strings, optional): Arguments to pass to the command
+
+**Example:**
+```json
+{
+  "command": "make:model",
+  "args": ["User", "--migration"]
+}
+```
+
+## Security
+
+### Blacklisted Commands
+
+The following commands are blacklisted for security reasons:
+- `db:wipe`
+- `migration:fresh`
+- `migration:refresh`
+- `migration:reset`
+
+Attempting to run these commands will result in an error.
+
+### Shell Injection Protection
+
+All command arguments are validated to prevent shell injection attacks. The following characters are not allowed:
+- `;` (semicolon)
+- `&` (ampersand)
+- `|` (pipe)
+- `` ` `` (backtick)
+- `$` (dollar sign)
+- `()` (parentheses)
+- `{}` (curly braces)
+- `[]` (square brackets)
+- `<>` (angle brackets)
+- `\` (backslash)
+
+## Configuration
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "adonisjs": {
+      "command": "npx",
+      "args": ["-y", "@mkrlbs/mcp-adonisjs"]
+    }
+  }
+}
+```
+
+### Other MCP Clients
+
+The server uses stdio transport and can be configured with any MCP-compatible client. Provide the command:
+
+```bash
+npx @mkrlbs/mcp-adonisjs
+```
+
+## Development
+
+### Building
+
+```bash
+npm run build
+```
+
+### Watch Mode
+
+```bash
+npm run watch
+```
+
+## Requirements
+
+- Node.js 18+
+- An AdonisJS project in the current working directory
+
+## License
+
+MIT
+

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,231 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { execSync } from "child_process";
+/**
+ * Blacklisted commands that are considered dangerous
+ */
+const BLACKLISTED_COMMANDS = [
+    "db:wipe",
+    "migration:fresh",
+    "migration:refresh",
+    "migration:reset",
+];
+/**
+ * Shell injection characters that are not allowed in command arguments
+ */
+const SHELL_INJECTION_PATTERN = /[;&|`$(){}[\]<>\\]/;
+/**
+ * Validates that command arguments don't contain shell injection characters
+ */
+function validateArguments(args) {
+    for (const arg of args) {
+        if (SHELL_INJECTION_PATTERN.test(arg)) {
+            throw new Error(`Invalid argument "${arg}": contains potentially dangerous characters`);
+        }
+    }
+}
+/**
+ * Checks if a command is blacklisted
+ */
+function isBlacklisted(command) {
+    return BLACKLISTED_COMMANDS.includes(command);
+}
+/**
+ * Executes an Ace command safely
+ */
+function executeAceCommand(command, args = []) {
+    // Check blacklist
+    if (isBlacklisted(command)) {
+        throw new Error(`Command "${command}" is blacklisted for security reasons. Blocked commands: ${BLACKLISTED_COMMANDS.join(", ")}`);
+    }
+    // Validate arguments
+    validateArguments(args);
+    // Build the command
+    const fullCommand = `node ace ${command} ${args.join(" ")}`.trim();
+    try {
+        const output = execSync(fullCommand, {
+            cwd: process.cwd(),
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        return output;
+    }
+    catch (error) {
+        throw new Error(`Command execution failed: ${error.message}\nStderr: ${error.stderr || "N/A"}`);
+    }
+}
+/**
+ * Schema definitions for tool arguments
+ */
+const MakeControllerArgsSchema = z.object({
+    name: z.string().describe("Name of the controller to create"),
+    resource: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Whether to create a resource controller"),
+});
+const MakeServiceArgsSchema = z.object({
+    name: z.string().describe("Name of the service to create"),
+});
+const RunAceCommandArgsSchema = z.object({
+    command: z.string().describe("The Ace command to run (e.g., 'make:model')"),
+    args: z
+        .array(z.string())
+        .optional()
+        .default([])
+        .describe("Arguments to pass to the command"),
+});
+/**
+ * Initialize the MCP server
+ */
+const server = new Server({
+    name: "adonisjs-mcp-server",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+/**
+ * Handler for listing available tools
+ */
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "make_controller",
+                description: "Creates an AdonisJS controller using the 'node ace make:controller' command",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "Name of the controller to create",
+                        },
+                        resource: {
+                            type: "boolean",
+                            description: "Whether to create a resource controller",
+                            default: false,
+                        },
+                    },
+                    required: ["name"],
+                },
+            },
+            {
+                name: "make_service",
+                description: "Creates an AdonisJS service using the 'node ace make:service' command",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "Name of the service to create",
+                        },
+                    },
+                    required: ["name"],
+                },
+            },
+            {
+                name: "run_ace_command",
+                description: "Executes an AdonisJS Ace command with security checks. Blacklisted commands: " +
+                    BLACKLISTED_COMMANDS.join(", "),
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        command: {
+                            type: "string",
+                            description: "The Ace command to run (e.g., 'make:model')",
+                        },
+                        args: {
+                            type: "array",
+                            items: {
+                                type: "string",
+                            },
+                            description: "Arguments to pass to the command",
+                            default: [],
+                        },
+                    },
+                    required: ["command"],
+                },
+            },
+        ],
+    };
+});
+/**
+ * Handler for executing tools
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        switch (name) {
+            case "make_controller": {
+                const parsed = MakeControllerArgsSchema.parse(args);
+                const commandArgs = parsed.resource ? [parsed.name, "--resource"] : [parsed.name];
+                const output = executeAceCommand("make:controller", commandArgs);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Controller created successfully:\n${output}`,
+                        },
+                    ],
+                };
+            }
+            case "make_service": {
+                const parsed = MakeServiceArgsSchema.parse(args);
+                const output = executeAceCommand("make:service", [parsed.name]);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Service created successfully:\n${output}`,
+                        },
+                    ],
+                };
+            }
+            case "run_ace_command": {
+                const parsed = RunAceCommandArgsSchema.parse(args);
+                const output = executeAceCommand(parsed.command, parsed.args);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Command executed successfully:\n${output}`,
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+/**
+ * Start the server
+ */
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Use stderr for logging since stdout is used for MCP protocol communication
+    console.error("AdonisJS MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@mkrlbs/mcp-adonisjs",
+  "version": "0.1.0",
+  "description": "MCP server for executing AdonisJS Ace commands",
+  "type": "module",
+  "bin": {
+    "mcp-adonisjs": "./build/index.js"
+  },
+  "files": [
+    "build",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "test": "node tests/security.test.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "adonisjs",
+    "ace"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,264 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { execSync } from "child_process";
+
+/**
+ * Blacklisted commands that are considered dangerous
+ */
+const BLACKLISTED_COMMANDS = [
+  "db:wipe",
+  "migration:fresh",
+  "migration:refresh",
+  "migration:reset",
+];
+
+/**
+ * Shell injection characters that are not allowed in command arguments
+ */
+const SHELL_INJECTION_PATTERN = /[;&|`$(){}[\]<>\\]/;
+
+/**
+ * Validates that command arguments don't contain shell injection characters
+ */
+function validateArguments(args: string[]): void {
+  for (const arg of args) {
+    if (SHELL_INJECTION_PATTERN.test(arg)) {
+      throw new Error(
+        `Invalid argument "${arg}": contains potentially dangerous characters`
+      );
+    }
+  }
+}
+
+/**
+ * Checks if a command is blacklisted
+ */
+function isBlacklisted(command: string): boolean {
+  return BLACKLISTED_COMMANDS.includes(command);
+}
+
+/**
+ * Executes an Ace command safely
+ */
+function executeAceCommand(command: string, args: string[] = []): string {
+  // Check blacklist
+  if (isBlacklisted(command)) {
+    throw new Error(
+      `Command "${command}" is blacklisted for security reasons. Blocked commands: ${BLACKLISTED_COMMANDS.join(", ")}`
+    );
+  }
+
+  // Validate arguments
+  validateArguments(args);
+
+  // Build the command
+  const fullCommand = `node ace ${command} ${args.join(" ")}`.trim();
+
+  try {
+    const output = execSync(fullCommand, {
+      cwd: process.cwd(),
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+    });
+    return output;
+  } catch (error: any) {
+    throw new Error(
+      `Command execution failed: ${error.message}\nStderr: ${error.stderr || "N/A"}`
+    );
+  }
+}
+
+/**
+ * Schema definitions for tool arguments
+ */
+const MakeControllerArgsSchema = z.object({
+  name: z.string().describe("Name of the controller to create"),
+  resource: z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe("Whether to create a resource controller"),
+});
+
+const MakeServiceArgsSchema = z.object({
+  name: z.string().describe("Name of the service to create"),
+});
+
+const RunAceCommandArgsSchema = z.object({
+  command: z.string().describe("The Ace command to run (e.g., 'make:model')"),
+  args: z
+    .array(z.string())
+    .optional()
+    .default([])
+    .describe("Arguments to pass to the command"),
+});
+
+/**
+ * Initialize the MCP server
+ */
+const server = new Server(
+  {
+    name: "adonisjs-mcp-server",
+    version: "0.1.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+/**
+ * Handler for listing available tools
+ */
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "make_controller",
+        description:
+          "Creates an AdonisJS controller using the 'node ace make:controller' command",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: "Name of the controller to create",
+            },
+            resource: {
+              type: "boolean",
+              description: "Whether to create a resource controller",
+              default: false,
+            },
+          },
+          required: ["name"],
+        },
+      },
+      {
+        name: "make_service",
+        description:
+          "Creates an AdonisJS service using the 'node ace make:service' command",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: "Name of the service to create",
+            },
+          },
+          required: ["name"],
+        },
+      },
+      {
+        name: "run_ace_command",
+        description:
+          "Executes an AdonisJS Ace command with security checks. Blacklisted commands: " +
+          BLACKLISTED_COMMANDS.join(", "),
+        inputSchema: {
+          type: "object",
+          properties: {
+            command: {
+              type: "string",
+              description: "The Ace command to run (e.g., 'make:model')",
+            },
+            args: {
+              type: "array",
+              items: {
+                type: "string",
+              },
+              description: "Arguments to pass to the command",
+              default: [],
+            },
+          },
+          required: ["command"],
+        },
+      },
+    ],
+  };
+});
+
+/**
+ * Handler for executing tools
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  try {
+    const { name, arguments: args } = request.params;
+
+    switch (name) {
+      case "make_controller": {
+        const parsed = MakeControllerArgsSchema.parse(args);
+        const commandArgs = parsed.resource ? [parsed.name, "--resource"] : [parsed.name];
+        const output = executeAceCommand("make:controller", commandArgs);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Controller created successfully:\n${output}`,
+            },
+          ],
+        };
+      }
+
+      case "make_service": {
+        const parsed = MakeServiceArgsSchema.parse(args);
+        const output = executeAceCommand("make:service", [parsed.name]);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Service created successfully:\n${output}`,
+            },
+          ],
+        };
+      }
+
+      case "run_ace_command": {
+        const parsed = RunAceCommandArgsSchema.parse(args);
+        const output = executeAceCommand(parsed.command, parsed.args);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Command executed successfully:\n${output}`,
+            },
+          ],
+        };
+      }
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error: any) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Error: ${error.message}`,
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+/**
+ * Start the server
+ */
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  // Use stderr for logging since stdout is used for MCP protocol communication
+  console.error("AdonisJS MCP Server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});