@cerema/cadriciel-mcp 0.1.0

package/src/tools/handlers.ts

@@ -0,0 +1,241 @@
+/**
+ * Tool Handlers Factory
+ *
+ * Creates tool handlers bound to a specific Cadriciel client.
+ * Used by the HTTP server where each session has its own client.
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+import { CadricielClient } from '../client';
+
+/**
+ * Tool definitions (schema only, handlers are created dynamically)
+ */
+const TOOL_DEFINITIONS = [
+  {
+    name: 'list_projects',
+    description: 'List all Cadriciel projects accessible by the authenticated user',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: 'get_project',
+    description: 'Get detailed information about a specific project',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        projectId: {
+          type: 'number',
+          description: 'The project ID',
+        },
+      },
+      required: ['projectId'],
+    },
+  },
+  {
+    name: 'list_workflows',
+    description: 'List all workflows in a workspace',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+      },
+      required: ['workspaceId'],
+    },
+  },
+  {
+    name: 'execute_workflow',
+    description: 'Execute a workflow with optional input parameters',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+        workflowId: {
+          type: 'string',
+          description: 'The workflow ID to execute',
+        },
+        input: {
+          type: 'object',
+          description: 'Input parameters for the workflow',
+        },
+      },
+      required: ['workspaceId', 'workflowId'],
+    },
+  },
+  {
+    name: 'get_execution',
+    description: 'Get the status and results of a workflow execution',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+        executionId: {
+          type: 'string',
+          description: 'The execution ID',
+        },
+      },
+      required: ['workspaceId', 'executionId'],
+    },
+  },
+  {
+    name: 'get_schema',
+    description: 'Get the database schema (tables, columns, relationships)',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+      },
+      required: ['workspaceId'],
+    },
+  },
+  {
+    name: 'query_database',
+    description: 'Execute a read-only SQL query (SELECT only)',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+        query: {
+          type: 'string',
+          description: 'SQL SELECT query to execute',
+        },
+      },
+      required: ['workspaceId', 'query'],
+    },
+  },
+];
+
+/**
+ * Create tool handler implementations bound to a client
+ */
+function createHandlers(client: CadricielClient) {
+  return {
+    // ============================================================
+    // IMPLEMENTED
+    // ============================================================
+
+    async list_projects() {
+      const response = await client.get('/api/studio/projects');
+      if (!response.success) {
+        throw new Error(`Failed to list projects: ${response.error}`);
+      }
+      const projects = (response.data || []).map((p: any) => ({
+        id: p.id,
+        name: p.name || p.title,
+        description: p.description,
+        path: p.path || p.path_with_namespace,
+        created_at: p.created_at,
+        updated_at: p.updated_at || p.last_activity_at,
+      }));
+      return { projects };
+    },
+
+    // ============================================================
+    // TODO: Implement these
+    // ============================================================
+
+    async get_project(args: { projectId: number }) {
+      // TODO: Implement
+      // const response = await client.get(`/api/studio/workspace/${args.projectId}`);
+      throw new Error('Not implemented yet');
+    },
+
+    async list_workflows(args: { workspaceId: number }) {
+      // TODO: Implement
+      // const response = await client.get(`/api/studio/workspace/${args.workspaceId}/airjobs/workflows`);
+      throw new Error('Not implemented yet');
+    },
+
+    async execute_workflow(args: { workspaceId: number; workflowId: string; input?: any }) {
+      // TODO: Implement
+      // const response = await client.post(`/api/studio/workspace/${args.workspaceId}/airjobs/execute`, { ... });
+      throw new Error('Not implemented yet');
+    },
+
+    async get_execution(args: { workspaceId: number; executionId: string }) {
+      // TODO: Implement
+      // const response = await client.get(`/api/studio/workspace/${args.workspaceId}/airjobs/executions?id=${args.executionId}`);
+      throw new Error('Not implemented yet');
+    },
+
+    async get_schema(args: { workspaceId: number }) {
+      // TODO: Implement
+      // const response = await client.get(`/api/studio/workspace/${args.workspaceId}/db/tables`);
+      throw new Error('Not implemented yet');
+    },
+
+    async query_database(args: { workspaceId: number; query: string }) {
+      // TODO: Implement
+      // IMPORTANT: Validate query is SELECT only
+      // const response = await client.post(`/api/studio/workspace/${args.workspaceId}/db/sql`, { sql: args.query });
+      throw new Error('Not implemented yet');
+    },
+  };
+}
+
+/**
+ * Register tool handlers with an MCP server
+ */
+export function createToolHandlers(server: Server, client: CadricielClient): void {
+  const handlers = createHandlers(client);
+
+  // List available tools
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOL_DEFINITIONS };
+  });
+
+  // Handle tool calls
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+
+    const handler = (handlers as any)[name];
+    if (!handler) {
+      throw new Error(`Unknown tool: ${name}`);
+    }
+
+    try {
+      const result = await handler(args);
+      return {
+        content: [
+          {
+            type: 'text',
+            text: JSON.stringify(result, null, 2),
+          },
+        ],
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Unknown error';
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Error: ${message}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  });
+}

package/src/tools/index.ts

@@ -0,0 +1,275 @@
+/**
+ * Tool Registry
+ *
+ * Registers all available MCP tools with their schemas and handlers.
+ */
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+
+import * as projects from './projects';
+import * as workflows from './workflows';
+import * as database from './database';
+import * as deploy from './deploy';
+
+/**
+ * Tool definitions for MCP
+ */
+const TOOLS = [
+  // ============================================================
+  // IMPLEMENTED
+  // ============================================================
+  {
+    name: 'list_projects',
+    description: 'List all Cadriciel projects accessible by the authenticated user',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+      required: [],
+    },
+    handler: projects.listProjects,
+  },
+
+  // ============================================================
+  // TODO: Implement handlers for these tools
+  // ============================================================
+  {
+    name: 'get_project',
+    description: 'Get detailed information about a specific project',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'number',
+          description: 'The project ID',
+        },
+      },
+      required: ['projectId'],
+    },
+    handler: async (args: { projectId: number }) => {
+      // TODO: Implement
+      throw new Error('Not implemented yet - see tools/projects.ts');
+    },
+  },
+  {
+    name: 'list_workflows',
+    description: 'List all workflows in a workspace',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+      },
+      required: ['workspaceId'],
+    },
+    handler: async (args: { workspaceId: number }) => {
+      // TODO: Implement
+      throw new Error('Not implemented yet - see tools/workflows.ts');
+    },
+  },
+  {
+    name: 'execute_workflow',
+    description: 'Execute a workflow with optional input parameters',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+        workflowId: {
+          type: 'string',
+          description: 'The workflow ID to execute',
+        },
+        input: {
+          type: 'object',
+          description: 'Input parameters for the workflow',
+        },
+      },
+      required: ['workspaceId', 'workflowId'],
+    },
+    handler: async (args: { workspaceId: number; workflowId: string; input?: any }) => {
+      // TODO: Implement
+      throw new Error('Not implemented yet - see tools/workflows.ts');
+    },
+  },
+  {
+    name: 'get_execution',
+    description: 'Get the status and results of a workflow execution',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+        executionId: {
+          type: 'string',
+          description: 'The execution ID',
+        },
+      },
+      required: ['workspaceId', 'executionId'],
+    },
+    handler: async (args: { workspaceId: number; executionId: string }) => {
+      // TODO: Implement
+      throw new Error('Not implemented yet - see tools/workflows.ts');
+    },
+  },
+  {
+    name: 'get_schema',
+    description: 'Get the database schema (tables, columns, relationships)',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+      },
+      required: ['workspaceId'],
+    },
+    handler: async (args: { workspaceId: number }) => {
+      // TODO: Implement
+      throw new Error('Not implemented yet - see tools/database.ts');
+    },
+  },
+  {
+    name: 'query_database',
+    description: 'Execute a read-only SQL query (SELECT only)',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+        query: {
+          type: 'string',
+          description: 'SQL SELECT query to execute',
+        },
+      },
+      required: ['workspaceId', 'query'],
+    },
+    handler: async (args: { workspaceId: number; query: string }) => {
+      // TODO: Implement
+      throw new Error('Not implemented yet - see tools/database.ts');
+    },
+  },
+  {
+    name: 'get_deployment_status',
+    description: 'Get the current deployment status of a project',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+      },
+      required: ['workspaceId'],
+    },
+    handler: async (args: { workspaceId: number }) => {
+      // TODO: Implement
+      throw new Error('Not implemented yet - see tools/deploy.ts');
+    },
+  },
+  {
+    name: 'get_env_vars',
+    description: 'Get environment variables for a project (values hidden)',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+      },
+      required: ['workspaceId'],
+    },
+    handler: async (args: { workspaceId: number }) => {
+      // TODO: Implement
+      throw new Error('Not implemented yet - see tools/deploy.ts');
+    },
+  },
+  {
+    name: 'service_control',
+    description: 'Control services (start, stop, restart)',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        workspaceId: {
+          type: 'number',
+          description: 'The workspace/project ID',
+        },
+        action: {
+          type: 'string',
+          enum: ['start', 'stop', 'restart'],
+          description: 'Action to perform',
+        },
+        service: {
+          type: 'string',
+          description: 'Optional specific service name',
+        },
+      },
+      required: ['workspaceId', 'action'],
+    },
+    handler: async (args: { workspaceId: number; action: string; service?: string }) => {
+      // TODO: Implement
+      throw new Error('Not implemented yet - see tools/deploy.ts');
+    },
+  },
+];
+
+/**
+ * Register all tools with the MCP server
+ */
+export function registerTools(server: Server): void {
+  // List available tools
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+      tools: TOOLS.map(({ name, description, inputSchema }) => ({
+        name,
+        description,
+        inputSchema,
+      })),
+    };
+  });
+
+  // Handle tool calls
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+
+    const tool = TOOLS.find((t) => t.name === name);
+    if (!tool) {
+      throw new Error(`Unknown tool: ${name}`);
+    }
+
+    try {
+      const result = await tool.handler(args as any);
+      return {
+        content: [
+          {
+            type: 'text',
+            text: JSON.stringify(result, null, 2),
+          },
+        ],
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : 'Unknown error';
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Error: ${message}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  });
+}

package/src/tools/projects.ts

@@ -0,0 +1,89 @@
+/**
+ * Project Tools
+ *
+ * Tools for managing Cadriciel projects.
+ */
+
+import { getClient } from '../client';
+
+// ============================================================
+// IMPLEMENTED
+// ============================================================
+
+/**
+ * List all projects accessible by the authenticated user
+ */
+export async function listProjects(): Promise<{
+  projects: Array<{
+    id: number;
+    name: string;
+    description?: string;
+    path: string;
+    created_at: string;
+    updated_at: string;
+  }>;
+}> {
+  const client = getClient();
+  const response = await client.get('/api/studio/projects');
+
+  if (!response.success) {
+    throw new Error(`Failed to list projects: ${response.error}`);
+  }
+
+  // Map the response to a cleaner format
+  const projects = (response.data || []).map((p: any) => ({
+    id: p.id,
+    name: p.name || p.title,
+    description: p.description,
+    path: p.path || p.path_with_namespace,
+    created_at: p.created_at,
+    updated_at: p.updated_at || p.last_activity_at,
+  }));
+
+  return { projects };
+}
+
+// ============================================================
+// TODO: Implement these tools
+// ============================================================
+
+/**
+ * TODO: Get detailed information about a specific project
+ *
+ * @param projectId - The project ID
+ * @returns Project details including config, members, environments
+ */
+export async function getProject(projectId: number): Promise<any> {
+  // TODO: Implement
+  // Endpoint: GET /api/studio/workspace/:projectId
+  throw new Error('Not implemented yet');
+}
+
+/**
+ * TODO: Create a new project
+ *
+ * @param options - Project creation options
+ * @returns Created project details
+ */
+export async function createProject(options: {
+  title: string;
+  description?: string;
+  template?: string;
+  mode?: 'fullstack' | 'frontend' | 'backend';
+  backendType?: 'node' | 'python' | 'springboot';
+}): Promise<any> {
+  // TODO: Implement
+  // Endpoint: POST /api/studio/projects
+  throw new Error('Not implemented yet');
+}
+
+/**
+ * TODO: Delete a project
+ *
+ * @param projectId - The project ID to delete
+ */
+export async function deleteProject(projectId: number): Promise<void> {
+  // TODO: Implement
+  // Endpoint: DELETE /api/studio/projects/:projectId
+  throw new Error('Not implemented yet');
+}