mcp-chain-of-thought

Instructions

Implementation Reference

• src/tools/taskTools.ts:1142-1197 (handler)

  The core handler function for the 'get_task_detail' tool. It fetches the task details using searchTasksWithCommand (which supports memory areas), generates a formatted prompt with getTaskDetailPrompt, and handles errors.

  export async function getTaskDetail({
    taskId,
  }: z.infer<typeof getTaskDetailSchema>) {
    try {
      // Use searchTasksWithCommand instead of getTaskById to implement memory area task search
      // Set isId to true to search by ID; page number is 1, page size is 1
      const result = await searchTasksWithCommand(taskId, true, 1, 1);
  
      // Check if the task is found
      if (result.tasks.length === 0) {
        return {
          content: [
            {
              type: "text" as const,
              text: `## Error\n\nTask with ID \`${taskId}\` not found. Please confirm if the task ID is correct.`,
            },
          ],
          isError: true,
        };
      }
  
      // Get the found task (the first and only one)
      const task = result.tasks[0];
  
      // Use prompt generator to get the final prompt
      const prompt = getTaskDetailPrompt({
        taskId,
        task,
      });
  
      return {
        content: [
          {
            type: "text" as const,
            text: prompt,
          },
        ],
      };
    } catch (error) {
      // Use prompt generator to get error message
      const errorPrompt = getTaskDetailPrompt({
        taskId,
        error: error instanceof Error ? error.message : String(error),
      });
  
      return {
        content: [
          {
            type: "text" as const,
            text: errorPrompt,
          },
        ],
        isError: true,
      };
    }
  }

• src/tools/taskTools.ts:1132-1139 (schema)

  Zod schema defining the input for getTaskDetail: requires a non-empty taskId string.

  export const getTaskDetailSchema = z.object({
    taskId: z
      .string()
      .min(1, {
        message: "Task ID cannot be empty, please provide a valid task ID",
      })
      .describe("Task ID to view details"),
  });

• src/index.ts:312-317 (registration)

  Tool registration in the MCP server's ListToolsRequest handler, specifying name, description from MD template, and JSON schema from Zod.

    name: "get_task_detail",
    description: loadPromptFromTemplate(
      "toolsDescription/getTaskDetail.md"
    ),
    inputSchema: zodToJsonSchema(getTaskDetailSchema),
  },

• src/index.ts:540-550 (handler)

  Dispatch handler in the MCP server's CallToolRequest handler: validates input with schema and calls the getTaskDetail function.

  case "get_task_detail":
    parsedArgs = await getTaskDetailSchema.safeParseAsync(
      request.params.arguments
    );
    if (!parsedArgs.success) {
      throw new Error(
        `Invalid arguments for tool ${request.params.name}: ${parsedArgs.error.message}`
      );
    }
    result = await getTaskDetail(parsedArgs.data);
    return result;