Task Manager MCP Server

Instructions

Implementation Reference

• tools/current_task.ts:20-52 (handler)

  The main handler function for the 'current_task' tool. It retrieves the current task from TaskDB, gets all tasks in its tree and incomplete tasks, formats them, and returns structured content with a note to use task_info for details.
  export async function handleCurrentTask(_: CurrentTaskArgs, taskDB: TaskDB) { const currentTaskID = taskDB.getCurrentTask() if (!currentTaskID) { const res = { tasks: [] } return { content: [], structuredContent: res, } satisfies CallToolResult } const tasksInTree = taskDB.getAllInTree(currentTaskID) const incompleteTaskIDs = taskDB.incompleteTasksInTree(currentTaskID).map((t) => t.taskID) const res = { tasks: tasksInTree.map((t) => toBasicTaskInfo(t, true, t.status !== DoneStatus && t.status !== FailedStatus, t.status === TodoStatus) ), incompleteTasksIdealOrder: incompleteTaskIDs, } return { content: [ { type: 'text', text: "Use 'task_info' tool to retrieve full task details", audience: ['assistant'], } satisfies TextContent, ], structuredContent: res, } satisfies CallToolResult }
• tools/current_task.ts:7-9 (schema)

  Zod schema definition for the input arguments of the current_task tool, which takes no parameters.
  export const CurrentTaskArgsSchema = z.object({}) type CurrentTaskArgs = z.infer<typeof CurrentTaskArgsSchema>
• tools/current_task.ts:11-18 (registration)

  Tool definition object with name, title, description, and JSON schema for input, used for MCP tool registration.
  export const CURRENT_TASK = 'current_task' export const currentTaskTool = { name: CURRENT_TASK, title: 'Get current task', description: 'Returns a list of tasks that are currently in progress.', inputSchema: zodToJsonSchema(CurrentTaskArgsSchema, { $refStrategy: 'none' }), }
• tools/index.ts:44-47 (registration)

  Registers the 'current_task' tool handler and schema in the central toolHandlers map.
  [CURRENT_TASK]: { handler: handleCurrentTask, schema: CurrentTaskArgsSchema, } satisfies ToolHandlerInfo,
• task_db.ts:19-21 (helper)

  TaskDB helper method to retrieve the ID of the current task, directly called by the handler.
  getCurrentTask(): TaskID | null { return this.currentTaskID }