@mtaap/mcp 0.2.1 → 0.2.2

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.2";
+
+// 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,42 +404,43 @@ 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 CreatePersonalProjectInputSchema = import_zod2.z.object({
@@ -450,7 +454,7 @@ var CreateOrganizationInputSchema = import_zod2.z.object({
   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 +477,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 +509,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 +529,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 +553,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(),
@@ -1121,7 +1125,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 +1155,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 +1187,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 +1213,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 +1249,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 +1286,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 +1346,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 +1384,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 +1414,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 +1444,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 +1480,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(
@@ -1538,6 +1593,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 +1705,7 @@ async function checkConnectivity() {
   }
 }
 async function main() {
+  handleCliFlags();
   console.error("[mtaap-mcp] Starting MTAAP MCP server...");
   validateEnvironment();
   await checkConnectivity();