MCP Task Manager Server

Instructions

Implementation Reference

• src/tools/showTaskTool.ts:16-44 (handler)

  The async processRequest function implements the core logic of the showTask tool: logs request, fetches task via TaskService.getTaskById, returns JSON stringified task as text content, handles NotFoundError and other errors appropriately.

  const processRequest = async (args: ShowTaskArgs) => {
      logger.info(`[${TOOL_NAME}] Received request with args:`, args);
      try {
          // Call the service method to get the task details
          const task = await taskService.getTaskById(args.project_id, args.task_id);
  
          // Format the successful response
          logger.info(`[${TOOL_NAME}] Found task ${args.task_id} in project ${args.project_id}`);
          return {
              content: [{
                  type: "text" as const,
                  text: JSON.stringify(task) // Return the full task object
              }]
          };
      } catch (error: unknown) {
          // Handle potential errors
          logger.error(`[${TOOL_NAME}] Error processing request:`, error);
  
          if (error instanceof NotFoundError) {
              // Specific error if the project or task wasn't found
              // Map to InvalidParams as the provided ID(s) are invalid in this context
              throw new McpError(ErrorCode.InvalidParams, error.message);
          } else {
              // Generic internal error
              const message = error instanceof Error ? error.message : 'An unknown error occurred while retrieving the task.';
              throw new McpError(ErrorCode.InternalError, message);
          }
      }
  };

• src/tools/showTaskParams.ts:3-24 (schema)

  Defines TOOL_NAME, TOOL_DESCRIPTION, TOOL_PARAMS Zod schema for input validation (project_id: UUID string, task_id: non-empty string), and inferred ShowTaskArgs type.

  export const TOOL_NAME = "showTask";
  
  export const TOOL_DESCRIPTION = `
  Retrieves the full details of a single, specific task, including its dependencies and direct subtasks.
  Requires the project ID and the task ID.
  Returns a task object containing all details if found.
  `;
  
  // Zod schema for the parameters, matching FR-004 and showTaskTool.md spec
  export const TOOL_PARAMS = z.object({
      project_id: z.string()
          .uuid("The project_id must be a valid UUID.")
          .describe("The unique identifier (UUID) of the project the task belongs to."), // Required, UUID format
  
      task_id: z.string()
          // Add .uuid() if task IDs are also UUIDs, otherwise keep as string
          .min(1, "Task ID cannot be empty.")
          .describe("The unique identifier of the task to retrieve details for."), // Required, string (or UUID)
  });
  
  // Define the expected type for arguments based on the Zod schema
  export type ShowTaskArgs = z.infer<typeof TOOL_PARAMS>;

• src/tools/showTaskTool.ts:46-48 (registration)

  Registers the showTask tool on the MCP server using server.tool() with name, description, param schema, and handler function.

  // Register the tool with the server
  server.tool(TOOL_NAME, TOOL_DESCRIPTION, TOOL_PARAMS.shape, processRequest);

• src/tools/index.ts:56-56 (registration)

  Calls showTaskTool registration function during overall tool registration in index.ts, passing server and taskService instance.

  showTaskTool(server, taskService);