@mtaap/mcp 0.2.1 → 0.2.3

package/dist/cli.js

@@ -28,16 +28,19 @@ var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 
 // src/version.ts
-var VERSION = "0.2.1";
+var VERSION = "0.2.3";
+
+// src/index.ts
+var import_zod3 = require("zod");
 
 // ../../packages/core/dist/constants/enums.js
 var TaskState;
-(function(TaskState3) {
-  TaskState3["BACKLOG"] = "BACKLOG";
-  TaskState3["READY"] = "READY";
-  TaskState3["IN_PROGRESS"] = "IN_PROGRESS";
-  TaskState3["REVIEW"] = "REVIEW";
-  TaskState3["DONE"] = "DONE";
+(function(TaskState2) {
+  TaskState2["BACKLOG"] = "BACKLOG";
+  TaskState2["READY"] = "READY";
+  TaskState2["IN_PROGRESS"] = "IN_PROGRESS";
+  TaskState2["REVIEW"] = "REVIEW";
+  TaskState2["DONE"] = "DONE";
 })(TaskState || (TaskState = {}));
 var UserRole;
 (function(UserRole2) {
@@ -401,56 +404,78 @@ var ListTasksInputSchema = import_zod2.z.object({
   state: import_zod2.z.nativeEnum(TaskState).optional(),
   assigneeId: import_zod2.z.string().optional()
 });
+var cuidOrPrefixedId = import_zod2.z.string().regex(/^([a-z0-9]+|[a-z]+_[a-zA-Z0-9]+)$/);
 var GetTaskInputSchema = import_zod2.z.object({
-  taskId: import_zod2.z.string().regex(/^tsk_[a-zA-Z0-9]+$/)
+  taskId: cuidOrPrefixedId
 });
 var AssignTaskInputSchema = import_zod2.z.object({
-  projectId: import_zod2.z.string().regex(/^prj_[a-zA-Z0-9]+$/),
-  taskId: import_zod2.z.string().regex(/^tsk_[a-zA-Z0-9]+$/),
+  projectId: cuidOrPrefixedId,
+  taskId: cuidOrPrefixedId,
   expectedState: import_zod2.z.nativeEnum(TaskState).default(TaskState.READY)
 });
 var UpdateProgressInputSchema = import_zod2.z.object({
-  taskId: import_zod2.z.string().regex(/^tsk_[a-zA-Z0-9]+$/),
+  taskId: cuidOrPrefixedId,
   statusMessage: import_zod2.z.string().max(1e3).optional(),
   completedCheckpointIds: import_zod2.z.array(import_zod2.z.string()).optional(),
   currentCheckpointIndex: import_zod2.z.number().int().optional()
 });
 var CompleteTaskInputSchema = import_zod2.z.object({
-  projectId: import_zod2.z.string().regex(/^prj_[a-zA-Z0-9]+$/),
-  taskId: import_zod2.z.string().regex(/^tsk_[a-zA-Z0-9]+$/),
+  projectId: cuidOrPrefixedId,
+  taskId: cuidOrPrefixedId,
   pullRequestTitle: import_zod2.z.string().min(1).max(300).optional(),
   pullRequestBody: import_zod2.z.string().max(1e4).optional()
 });
 var ReportErrorInputSchema = import_zod2.z.object({
-  taskId: import_zod2.z.string().regex(/^tsk_[a-zA-Z0-9]+$/),
+  taskId: cuidOrPrefixedId,
   errorType: import_zod2.z.nativeEnum(ErrorType),
   errorMessage: import_zod2.z.string().min(1).max(1e3),
   context: import_zod2.z.string().max(2e3).optional()
 });
 var GetProjectContextInputSchema = import_zod2.z.object({
-  projectId: import_zod2.z.string().regex(/^prj_[a-zA-Z0-9]+$/)
+  projectId: cuidOrPrefixedId
 });
 var AddNoteInputSchema = import_zod2.z.object({
-  taskId: import_zod2.z.string().regex(/^tsk_[a-zA-Z0-9]+$/),
+  taskId: cuidOrPrefixedId,
   content: import_zod2.z.string().min(1).max(500)
 });
 var AbandonTaskInputSchema = import_zod2.z.object({
-  projectId: import_zod2.z.string().regex(/^prj_[a-zA-Z0-9]+$/),
-  taskId: import_zod2.z.string().regex(/^tsk_[a-zA-Z0-9]+$/),
+  projectId: cuidOrPrefixedId,
+  taskId: cuidOrPrefixedId,
   deleteBranch: import_zod2.z.boolean().optional()
 });
+var RequestChangesInputSchema = import_zod2.z.object({
+  projectId: cuidOrPrefixedId,
+  taskId: cuidOrPrefixedId,
+  reviewComments: import_zod2.z.string().min(1).max(5e3),
+  requestedChanges: import_zod2.z.array(import_zod2.z.string().min(1).max(500)).optional()
+});
+var ApproveTaskInputSchema = import_zod2.z.object({
+  projectId: cuidOrPrefixedId,
+  taskId: cuidOrPrefixedId,
+  reviewComments: import_zod2.z.string().max(2e3).optional()
+});
 var CreatePersonalProjectInputSchema = import_zod2.z.object({
   name: import_zod2.z.string().min(1).max(100),
   description: import_zod2.z.string().max(500).optional(),
   repositoryUrl: import_zod2.z.string().url()
 });
 var CheckActiveTaskInputSchema = import_zod2.z.object({});
+var CreateTaskMCPInputSchema = import_zod2.z.object({
+  projectId: cuidOrPrefixedId,
+  epicId: cuidOrPrefixedId.nullable().optional(),
+  title: import_zod2.z.string().min(1).max(200),
+  description: import_zod2.z.string().max(5e3),
+  priority: import_zod2.z.nativeEnum(TaskPriority).default(TaskPriority.MEDIUM),
+  acceptanceCriteria: import_zod2.z.array(import_zod2.z.object({
+    description: import_zod2.z.string().min(1).max(500)
+  })).min(1)
+});
 var CreateOrganizationInputSchema = import_zod2.z.object({
   name: import_zod2.z.string().min(1).max(255),
   slug: import_zod2.z.string().min(1).max(100).regex(/^[a-z0-9-]+$/).optional()
 });
 var UpdateOrganizationInputSchema = import_zod2.z.object({
-  organizationId: import_zod2.z.string().regex(/^org_[a-zA-Z0-9]+$/),
+  organizationId: cuidOrPrefixedId,
   name: import_zod2.z.string().min(1).max(255).optional(),
   logoUrl: import_zod2.z.string().url().nullable().optional(),
   accentColor: import_zod2.z.string().regex(/^#[0-9A-Fa-f]{6}$/, "Invalid hex color format. Expected #RRGGBB").nullable().optional(),
@@ -473,7 +498,7 @@ var UpdateProjectInputSchema = import_zod2.z.object({
   tags: import_zod2.z.array(import_zod2.z.string()).optional()
 });
 var CreateEpicInputSchema = import_zod2.z.object({
-  projectId: import_zod2.z.string().regex(/^prj_[a-zA-Z0-9]+$/),
+  projectId: cuidOrPrefixedId,
   name: import_zod2.z.string().min(1).max(200),
   description: import_zod2.z.string().max(2e3).optional()
 });
@@ -505,14 +530,14 @@ var AssignTaskWebappInputSchema = import_zod2.z.object({
   userId: import_zod2.z.string().min(1)
 });
 var CreateTagInputSchema = import_zod2.z.object({
-  organizationId: import_zod2.z.string().regex(/^org_[a-zA-Z0-9]+$/),
+  organizationId: cuidOrPrefixedId,
   name: import_zod2.z.string().min(1).max(50).regex(/^[a-zA-Z0-9\s-]+$/)
 });
 var UpdateTagInputSchema = import_zod2.z.object({
   name: import_zod2.z.string().min(1).max(50).regex(/^[a-zA-Z0-9\s-]+$/)
 });
 var UpdateOrganizationSettingsInputSchema = import_zod2.z.object({
-  organizationId: import_zod2.z.string().regex(/^org_[a-zA-Z0-9]+$/),
+  organizationId: cuidOrPrefixedId,
   ldapEnabled: import_zod2.z.boolean().optional(),
   ldapUrl: import_zod2.z.string().url().nullable().optional(),
   ldapBindDN: import_zod2.z.string().nullable().optional(),
@@ -525,21 +550,21 @@ var UpdateOrganizationSettingsInputSchema = import_zod2.z.object({
   tenantName: import_zod2.z.string().max(255).nullable().optional()
 });
 var InviteUserInputSchema = import_zod2.z.object({
-  organizationId: import_zod2.z.string().regex(/^org_[a-zA-Z0-9]+$/),
+  organizationId: cuidOrPrefixedId,
   email: import_zod2.z.string().email(),
   role: import_zod2.z.nativeEnum(UserRole).default(UserRole.MEMBER),
   tags: import_zod2.z.array(import_zod2.z.string()).default([])
 });
 var AssignUserTagsInputSchema = import_zod2.z.object({
-  userId: import_zod2.z.string().regex(/^usr_[a-zA-Z0-9]+$/),
+  userId: cuidOrPrefixedId,
   tags: import_zod2.z.array(import_zod2.z.string()).min(0)
 });
 var InviteCollaboratorInputSchema = import_zod2.z.object({
-  projectId: import_zod2.z.string().regex(/^prj_[a-zA-Z0-9]+$/),
+  projectId: cuidOrPrefixedId,
   email: import_zod2.z.string().email()
 });
 var PublishProjectInputSchema = import_zod2.z.object({
-  projectId: import_zod2.z.string().regex(/^prj_[a-zA-Z0-9]+$/),
+  projectId: cuidOrPrefixedId,
   transferOwnership: import_zod2.z.boolean().default(false),
   tags: import_zod2.z.array(import_zod2.z.string()).min(1)
 });
@@ -549,7 +574,7 @@ var GenerateApiKeyInputSchema = import_zod2.z.object({
   permissions: import_zod2.z.nativeEnum(ApiKeyPermission).default(ApiKeyPermission.WRITE)
 });
 var RevokeApiKeyInputSchema = import_zod2.z.object({
-  keyId: import_zod2.z.string().regex(/^key_[a-zA-Z0-9]+$/)
+  keyId: cuidOrPrefixedId
 });
 var LoginInputSchema = import_zod2.z.object({
   email: import_zod2.z.string().email(),
@@ -982,6 +1007,12 @@ var MCPApiClient = class {
       { name, description, repositoryUrl }
     );
   }
+  /**
+   * Create a task in a project
+   */
+  async createTask(input) {
+    return this.request("POST", "/api/mcp/tasks", input);
+  }
   /**
    * List tasks with optional filters
    */
@@ -1050,6 +1081,25 @@ var MCPApiClient = class {
   async addNote(taskId, content) {
     return this.request("POST", `/api/mcp/tasks/${taskId}/notes`, { content });
   }
+  /**
+   * Request changes on a task in review
+   */
+  async requestChanges(taskId, projectId, reviewComments, requestedChanges) {
+    return this.request("POST", `/api/mcp/tasks/${taskId}/request-changes`, {
+      projectId,
+      reviewComments,
+      requestedChanges
+    });
+  }
+  /**
+   * Approve a task in review and mark as DONE
+   */
+  async approveTask(taskId, projectId, reviewComments) {
+    return this.request("POST", `/api/mcp/tasks/${taskId}/approve`, {
+      projectId,
+      reviewComments
+    });
+  }
   /**
    * Get GitHub token
    */
@@ -1121,7 +1171,10 @@ async function createMCPServer() {
   server.registerTool(
     "list_projects",
     {
-      description: "List accessible projects (personal + team via tags)"
+      description: "List accessible projects (personal + team via tags)",
+      inputSchema: {
+        workspaceType: import_zod3.z.enum(["TEAM", "PERSONAL", "ALL"]).optional().describe("Filter by workspace type")
+      }
     },
     async (args) => {
       assertApiKeyPermission(
@@ -1148,7 +1201,12 @@ async function createMCPServer() {
   server.registerTool(
     "list_tasks",
     {
-      description: "Returns available tasks (filterable by project, state)"
+      description: "Returns available tasks (filterable by project, state)",
+      inputSchema: {
+        projectId: import_zod3.z.string().optional().describe("Filter by project ID"),
+        state: import_zod3.z.nativeEnum(TaskState).optional().describe("Filter by task state"),
+        assigneeId: import_zod3.z.string().optional().describe("Filter by assignee ID")
+      }
     },
     async (args) => {
       assertApiKeyPermission(mockApiKey, ApiKeyPermission.READ, "list_tasks");
@@ -1175,7 +1233,10 @@ async function createMCPServer() {
   server.registerTool(
     "get_task",
     {
-      description: "Full task details including acceptance criteria"
+      description: "Full task details including acceptance criteria",
+      inputSchema: {
+        taskId: import_zod3.z.string().describe("The task ID to retrieve")
+      }
     },
     async (args) => {
       assertApiKeyPermission(mockApiKey, ApiKeyPermission.READ, "get_task");
@@ -1198,7 +1259,12 @@ async function createMCPServer() {
   server.registerTool(
     "assign_task",
     {
-      description: "Atomic claim - creates branch. Fails if already taken."
+      description: "Atomic claim - creates branch. Fails if already taken.",
+      inputSchema: {
+        projectId: import_zod3.z.string().describe("The project ID"),
+        taskId: import_zod3.z.string().describe("The task ID to assign"),
+        expectedState: import_zod3.z.nativeEnum(TaskState).optional().describe("Expected task state (default: READY)")
+      }
     },
     async (args) => {
       assertApiKeyPermission(
@@ -1229,7 +1295,13 @@ async function createMCPServer() {
   server.registerTool(
     "update_progress",
     {
-      description: "Reports status, updates checkboxes, writes checkpoint"
+      description: "Reports status, updates checkboxes, writes checkpoint",
+      inputSchema: {
+        taskId: import_zod3.z.string().describe("The task ID to update"),
+        statusMessage: import_zod3.z.string().optional().describe("Status message (max 1000 chars)"),
+        completedCheckpointIds: import_zod3.z.array(import_zod3.z.string()).optional().describe("Array of completed checkpoint IDs"),
+        currentCheckpointIndex: import_zod3.z.number().optional().describe("Current checkpoint index")
+      }
     },
     async (args) => {
       assertApiKeyPermission(
@@ -1260,7 +1332,13 @@ async function createMCPServer() {
   server.registerTool(
     "complete_task",
     {
-      description: "Marks complete, triggers PR, deletes local state file"
+      description: "Marks complete, triggers PR, deletes local state file",
+      inputSchema: {
+        projectId: import_zod3.z.string().describe("The project ID"),
+        taskId: import_zod3.z.string().describe("The task ID to complete"),
+        pullRequestTitle: import_zod3.z.string().optional().describe("PR title (max 300 chars)"),
+        pullRequestBody: import_zod3.z.string().optional().describe("PR body/description (max 10000 chars)")
+      }
     },
     async (args) => {
       assertApiKeyPermission(
@@ -1314,7 +1392,13 @@ async function createMCPServer() {
   server.registerTool(
     "report_error",
     {
-      description: "Report unrecoverable error, displays on task in webapp"
+      description: "Report unrecoverable error, displays on task in webapp",
+      inputSchema: {
+        taskId: import_zod3.z.string().describe("The task ID"),
+        errorType: import_zod3.z.nativeEnum(ErrorType).describe("Error type: BUILD_FAILURE, TEST_FAILURE, CONFLICT, AUTH_ERROR, OTHER"),
+        errorMessage: import_zod3.z.string().describe("Error message (max 1000 chars)"),
+        context: import_zod3.z.string().optional().describe("Additional context (max 2000 chars)")
+      }
     },
     async (args) => {
       assertApiKeyPermission(
@@ -1346,7 +1430,10 @@ async function createMCPServer() {
   server.registerTool(
     "get_project_context",
     {
-      description: "Returns assembled context (README, stack, conventions)"
+      description: "Returns assembled context (README, stack, conventions)",
+      inputSchema: {
+        projectId: import_zod3.z.string().describe("The project ID")
+      }
     },
     async (args) => {
       assertApiKeyPermission(
@@ -1373,7 +1460,11 @@ async function createMCPServer() {
   server.registerTool(
     "add_note",
     {
-      description: "Append implementation notes to task"
+      description: "Append implementation notes to task",
+      inputSchema: {
+        taskId: import_zod3.z.string().describe("The task ID"),
+        content: import_zod3.z.string().describe("Note content (max 500 chars)")
+      }
     },
     async (args) => {
       assertApiKeyPermission(mockApiKey, ApiKeyPermission.WRITE, "add_note");
@@ -1399,7 +1490,12 @@ async function createMCPServer() {
   server.registerTool(
     "abandon_task",
     {
-      description: "Unassign from a task and optionally delete the branch"
+      description: "Unassign from a task and optionally delete the branch",
+      inputSchema: {
+        projectId: import_zod3.z.string().describe("The project ID"),
+        taskId: import_zod3.z.string().describe("The task ID to abandon"),
+        deleteBranch: import_zod3.z.boolean().optional().describe("Whether to delete the associated branch")
+      }
     },
     async (args) => {
       assertApiKeyPermission(
@@ -1430,7 +1526,12 @@ async function createMCPServer() {
   server.registerTool(
     "create_personal_project",
     {
-      description: "Create project in user's personal workspace"
+      description: "Create project in user's personal workspace",
+      inputSchema: {
+        name: import_zod3.z.string().describe("Project name (max 100 chars)"),
+        description: import_zod3.z.string().optional().describe("Project description (max 500 chars)"),
+        repositoryUrl: import_zod3.z.string().describe("GitHub repository URL")
+      }
     },
     async (args) => {
       assertApiKeyPermission(
@@ -1458,6 +1559,126 @@ async function createMCPServer() {
       }
     }
   );
+  server.registerTool(
+    "create_task",
+    {
+      description: "Create a new task in a project. Requires WRITE permission and project access.",
+      inputSchema: {
+        projectId: import_zod3.z.string().describe("The project ID to create the task in"),
+        epicId: import_zod3.z.string().nullable().optional().describe("Optional epic ID to associate the task with"),
+        title: import_zod3.z.string().describe("Task title (max 200 chars)"),
+        description: import_zod3.z.string().describe("Task description (max 5000 chars)"),
+        priority: import_zod3.z.nativeEnum(TaskPriority).optional().describe("Task priority: LOW, MEDIUM, HIGH, CRITICAL (default: MEDIUM)"),
+        acceptanceCriteria: import_zod3.z.array(
+          import_zod3.z.object({
+            description: import_zod3.z.string().describe("Acceptance criterion description (max 500 chars)")
+          })
+        ).describe("Array of acceptance criteria (at least 1 required)")
+      }
+    },
+    async (args) => {
+      assertApiKeyPermission(
+        mockApiKey,
+        ApiKeyPermission.WRITE,
+        "create_task"
+      );
+      const validated = CreateTaskMCPInputSchema.parse(args);
+      try {
+        const result = await apiClient.createTask({
+          projectId: validated.projectId,
+          epicId: validated.epicId,
+          title: validated.title,
+          description: validated.description,
+          priority: validated.priority,
+          acceptanceCriteria: validated.acceptanceCriteria
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2)
+            }
+          ]
+        };
+      } catch (error) {
+        return handleApiError(error);
+      }
+    }
+  );
+  server.registerTool(
+    "request_changes",
+    {
+      description: "Submit review comments requesting changes on a task in REVIEW state",
+      inputSchema: {
+        projectId: import_zod3.z.string().describe("The project ID"),
+        taskId: import_zod3.z.string().describe("The task ID to review"),
+        reviewComments: import_zod3.z.string().describe("Review comments explaining requested changes (max 5000 chars)"),
+        requestedChanges: import_zod3.z.array(import_zod3.z.string()).optional().describe("List of specific changes requested")
+      }
+    },
+    async (args) => {
+      assertApiKeyPermission(
+        mockApiKey,
+        ApiKeyPermission.WRITE,
+        "request_changes"
+      );
+      const validated = RequestChangesInputSchema.parse(args);
+      try {
+        const result = await apiClient.requestChanges(
+          validated.taskId,
+          validated.projectId,
+          validated.reviewComments,
+          validated.requestedChanges
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2)
+            }
+          ]
+        };
+      } catch (error) {
+        return handleApiError(error);
+      }
+    }
+  );
+  server.registerTool(
+    "approve_task",
+    {
+      description: "Approve a task in REVIEW state and mark it as DONE",
+      inputSchema: {
+        projectId: import_zod3.z.string().describe("The project ID"),
+        taskId: import_zod3.z.string().describe("The task ID to approve"),
+        reviewComments: import_zod3.z.string().optional().describe("Optional approval comments (max 2000 chars)")
+      }
+    },
+    async (args) => {
+      assertApiKeyPermission(
+        mockApiKey,
+        ApiKeyPermission.WRITE,
+        "approve_task"
+      );
+      const validated = ApproveTaskInputSchema.parse(args);
+      try {
+        const result = await apiClient.approveTask(
+          validated.taskId,
+          validated.projectId,
+          validated.reviewComments
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2)
+            }
+          ]
+        };
+      } catch (error) {
+        return handleApiError(error);
+      }
+    }
+  );
   server.registerTool(
     "get_version",
     {
@@ -1538,6 +1759,44 @@ async function checkActiveTask() {
 }
 
 // src/cli.ts
+function handleCliFlags() {
+  const args = process.argv.slice(2);
+  if (args.includes("--version") || args.includes("-v")) {
+    console.log(`mtaap-mcp v${VERSION}`);
+    process.exit(0);
+  }
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(`mtaap-mcp v${VERSION}
+
+MTAAP MCP Server - Model Context Protocol server for MTAAP
+
+Usage:
+  mtaap-mcp [options]
+
+Options:
+  -v, --version    Show version number
+  -h, --help       Show this help message
+
+Environment Variables:
+  MTAAP_API_KEY    Your MTAAP API key (required)
+  MTAAP_BASE_URL   MTAAP webapp URL (required)
+
+Example mcp.json configuration:
+{
+  "mcpServers": {
+    "mtaap": {
+      "command": "npx",
+      "args": ["@mtaap/mcp"],
+      "env": {
+        "MTAAP_API_KEY": "usr_your_api_key_here",
+        "MTAAP_BASE_URL": "https://collab.mtaap.de"
+      }
+    }
+  }
+}`);
+    process.exit(0);
+  }
+}
 function validateEnvironment() {
   const errors = [];
   if (!process.env.MTAAP_API_KEY) {
@@ -1612,6 +1871,7 @@ async function checkConnectivity() {
   }
 }
 async function main() {
+  handleCliFlags();
   console.error("[mtaap-mcp] Starting MTAAP MCP server...");
   validateEnvironment();
   await checkConnectivity();