task-orchestrator-mcp

Instructions

Implementation Reference

• src/tools.ts:117-159 (registration)

  Registration of the MCP 'getTask' tool using server.registerTool. Defines the tool name, description, input schema requiring a task ID string, and a handler function that calls the underlying getTask implementation, formats the response as JSON, and handles errors.

  // Register getTask tool
  server.registerTool(
    "getTask",
    {
      description: "Get a task by its ID",
      inputSchema: {
        id: z.string().describe("Task ID"),
      },
    },
    (args) => {
      try {
        const task = getTask(args.id)
        return {
          content: [
            {
              text: JSON.stringify({ task }, null, 2),
              type: "text",
            },
          ],
        }
      } catch (error) {
        return {
          content: [
            {
              text: JSON.stringify(
                {
                  error: {
                    code: "TASK_NOT_FOUND",
                    message:
                      error instanceof Error ? error.message : "Unknown error",
                  },
                },
                null,
                2,
              ),
              type: "text",
            },
          ],
          isError: true,
        }
      }
    },
  )

• src/task.ts:555-568 (handler)

  Core handler function for retrieving a task by ID. Validates input, loads all tasks from storage, searches recursively using findTaskById, throws appropriate errors if invalid ID or not found, returns the Task object.

  export function getTask(id: string): Task {
    if (!id || typeof id !== "string") {
      throw new Error(ERROR_MESSAGES.INVALID_TASK_ID)
    }
  
    const tasks = readTasks()
    const task = findTaskById(tasks, id)
  
    if (!task) {
      throw new Error(ERROR_MESSAGES.TASK_NOT_FOUND(id))
    }
  
    return task
  }

• src/tools.ts:120-125 (schema)

  Input schema definition for the getTask tool using Zod: requires 'id' as a string with description.

  {
    description: "Get a task by its ID",
    inputSchema: {
      id: z.string().describe("Task ID"),
    },
  },

• src/task.ts:33-44 (helper)

  Recursive helper function to find a task by ID in the nested task hierarchy.

  export function findTaskById(tasks: Task[], id: string): Task | undefined {
    for (const task of tasks) {
      if (task.id === id) {
        return task
      }
      const found = findTaskById(task.tasks, id)
      if (found) {
        return found
      }
    }
    return undefined
  }