An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.
JavaScript aicursorcursor-aicursorailovablelovable-devroocodetask-managertaskstasks-listwindsurfwindsurf-ai
feat(mcp): Implement generate MCP command for creating task files from tasks.json
Eyal Toledanod4f92858c27c
diff --git a/.changeset/two-bats-smoke.md b/.changeset/two-bats-smoke.mdindex 7fafd39e..3ca6add3 100644--- a/.changeset/two-bats-smoke.md+++ b/.changeset/two-bats-smoke.md@@ -5,3 +5,4 @@- Split monolithic task-master-core.js into separate function files within direct-functions directory- Implement update-task MCP command for updating a single task by ID- Implement update-subtask MCP command for appending information to specific subtasks+- Implement generate MCP command for creating individual task files from tasks.jsondiff --git a/mcp-server/src/core/direct-functions/generate-task-files.js b/mcp-server/src/core/direct-functions/generate-task-files.jsnew file mode 100644index 00000000..9f6b4592--- /dev/null+++ b/mcp-server/src/core/direct-functions/generate-task-files.js@@ -0,0 +1,64 @@+/**+ * generate-task-files.js+ * Direct function implementation for generating task files from tasks.json+ */++import { generateTaskFiles } from '../../../../scripts/modules/task-manager.js';+import { findTasksJsonPath } from '../utils/path-utils.js';+import path from 'path';++/**+ * Direct function wrapper for generateTaskFiles with error handling.+ *+ * @param {Object} args - Command arguments containing file and output path options.+ * @param {Object} log - Logger object.+ * @returns {Promise<Object>} - Result object with success status and data/error information.+ */+export async function generateTaskFilesDirect(args, log) {+ try {+ log.info(`Generating task files with args: ${JSON.stringify(args)}`);++ // Get tasks file path+ let tasksPath;+ try {+ tasksPath = findTasksJsonPath(args, log);+ } catch (error) {+ log.error(`Error finding tasks file: ${error.message}`);+ return {+ success: false,+ error: { code: 'TASKS_FILE_ERROR', message: error.message },+ fromCache: false+ };+ }++ // Get output directory (defaults to the same directory as the tasks file)+ let outputDir = args.output;+ if (!outputDir) {+ outputDir = path.dirname(tasksPath);+ }++ log.info(`Generating task files from ${tasksPath} to ${outputDir}`);++ // Execute core generateTaskFiles function+ generateTaskFiles(tasksPath, outputDir);++ // Return success with file paths+ return {+ success: true,+ data: {+ message: `Successfully generated task files`,+ tasksPath,+ outputDir,+ taskFiles: 'Individual task files have been generated in the output directory'+ },+ fromCache: false // This operation always modifies state and should never be cached+ };+ } catch (error) {+ log.error(`Error generating task files: ${error.message}`);+ return {+ success: false,+ error: { code: 'GENERATE_TASKS_ERROR', message: error.message || 'Unknown error generating task files' },+ fromCache: false+ };+ }+}\ No newline at end of filediff --git a/mcp-server/src/core/task-master-core.js b/mcp-server/src/core/task-master-core.jsindex c291b0f2..fbcb5b03 100644--- a/mcp-server/src/core/task-master-core.js+++ b/mcp-server/src/core/task-master-core.js@@ -11,6 +11,7 @@ import { parsePRDDirect } from './direct-functions/parse-prd.js';import { updateTasksDirect } from './direct-functions/update-tasks.js';import { updateTaskByIdDirect } from './direct-functions/update-task-by-id.js';import { updateSubtaskByIdDirect } from './direct-functions/update-subtask-by-id.js';+import { generateTaskFilesDirect } from './direct-functions/generate-task-files.js';// Re-export utility functionsexport { findTasksJsonPath } from './utils/path-utils.js';@@ -23,6 +24,7 @@ export {updateTasksDirect,updateTaskByIdDirect,updateSubtaskByIdDirect,+ generateTaskFilesDirect,};/**@@ -36,5 +38,6 @@ export const directFunctions = {update: updateTasksDirect,updateTask: updateTaskByIdDirect,updateSubtask: updateSubtaskByIdDirect,+ generate: generateTaskFilesDirect,// Add more functions as we implement them};\ No newline at end of filediff --git a/mcp-server/src/tools/generate.js b/mcp-server/src/tools/generate.jsnew file mode 100644index 00000000..50f1093a--- /dev/null+++ b/mcp-server/src/tools/generate.js@@ -0,0 +1,49 @@+/**+ * tools/generate.js+ * Tool to generate individual task files from tasks.json+ */++import { z } from "zod";+import {+ handleApiResult,+ createErrorResponse+} from "./utils.js";+import { generateTaskFilesDirect } from "../core/task-master-core.js";++/**+ * Register the generate tool with the MCP server+ * @param {Object} server - FastMCP server instance+ */+export function registerGenerateTool(server) {+ server.addTool({+ name: "generate",+ description: "Generates individual task files in tasks/ directory based on tasks.json",+ parameters: z.object({+ file: z.string().optional().describe("Path to the tasks file"),+ output: z.string().optional().describe("Output directory (default: same directory as tasks file)"),+ projectRoot: z+ .string()+ .optional()+ .describe(+ "Root directory of the project (default: current working directory)"+ ),+ }),+ execute: async (args, { log }) => {+ try {+ log.info(`Generating task files with args: ${JSON.stringify(args)}`);++ // Call the direct function wrapper+ const result = await generateTaskFilesDirect(args, log);++ // Log result+ log.info(`${result.success ? 'Successfully generated task files' : 'Failed to generate task files'}`);++ // Use handleApiResult to format the response+ return handleApiResult(result, log, 'Error generating task files');+ } catch (error) {+ log.error(`Error in generate tool: ${error.message}`);+ return createErrorResponse(error.message);+ }+ },+ });+}\ No newline at end of filediff --git a/mcp-server/src/tools/index.js b/mcp-server/src/tools/index.jsindex ed7ee99f..2b0122f6 100644--- a/mcp-server/src/tools/index.js+++ b/mcp-server/src/tools/index.js@@ -14,6 +14,7 @@ import { registerParsePRDTool } from "./parsePRD.js";import { registerUpdateTool } from "./update.js";import { registerUpdateTaskTool } from "./update-task.js";import { registerUpdateSubtaskTool } from "./update-subtask.js";+import { registerGenerateTool } from "./generate.js";/*** Register all Task Master tools with the MCP server@@ -30,6 +31,7 @@ export function registerTaskMasterTools(server) {registerUpdateTool(server);registerUpdateTaskTool(server);registerUpdateSubtaskTool(server);+ registerGenerateTool(server);}export default {diff --git a/tasks/task_023.txt b/tasks/task_023.txtindex 62e2524b..f0fe6bd1 100644--- a/tasks/task_023.txt+++ b/tasks/task_023.txt@@ -438,7 +438,7 @@ Following MCP implementation standards:- Unit test for updateSubtaskByIdDirect.js- Integration test for MCP tool-## 20. Implement generate MCP command [pending]+## 20. Implement generate MCP command [done]### Dependencies: None### Description: Create direct function wrapper and MCP tool for generating task files from tasks.json.### Details:diff --git a/tasks/tasks.json b/tasks/tasks.jsonindex 9bdf4826..d274bcf3 100644--- a/tasks/tasks.json+++ b/tasks/tasks.json@@ -1528,7 +1528,7 @@"title": "Implement generate MCP command","description": "Create direct function wrapper and MCP tool for generating task files from tasks.json.","details": "Following MCP implementation standards:\n\n1. Create generateTaskFilesDirect.js in mcp-server/src/core/direct-functions/:\n - Import generateTaskFiles from task-manager.js\n - Handle file paths using findTasksJsonPath utility\n - Process arguments: tasksPath, outputDir\n - Validate inputs and handle errors with try/catch\n - Return standardized { success, data/error } object\n\n2. Export from task-master-core.js:\n - Import the function from its file\n - Add to directFunctions map\n\n3. Create generate.js MCP tool in mcp-server/src/tools/:\n - Import z from zod for parameter schema\n - Import executeMCPToolAction from ./utils.js\n - Import generateTaskFilesDirect from task-master-core.js\n - Define parameters matching CLI options using zod schema\n - Implement registerGenerateTool(server) with server.addTool\n - Use executeMCPToolAction in execute method\n\n4. Register in tools/index.js\n\n5. Add to .cursor/mcp.json with appropriate schema\n\n6. Write tests following testing guidelines:\n - Unit test for generateTaskFilesDirect.js\n - Integration test for MCP tool",- "status": "pending",+ "status": "done","dependencies": [],"parentTaskId": 23},