An AI-powered task-management system you can drop into Cursor, Lovable, Windsurf, Roo, and others.
JavaScript aicursorcursor-aicursorailovablelovable-devroocodetask-managertaskstasks-listwindsurfwindsurf-ai
Implement analyze-complexity MCP command for analyzing task complexity
Eyal Toledano0b7b395aa4ac
diff --git a/.changeset/two-bats-smoke.md b/.changeset/two-bats-smoke.mdindex bfb2526b..171be06c 100644--- a/.changeset/two-bats-smoke.md+++ b/.changeset/two-bats-smoke.md@@ -13,4 +13,5 @@- Implement add-task MCP command for creating new tasks using AI assistance- Implement add-subtask MCP command for adding subtasks to existing tasks- Implement remove-subtask MCP command for removing subtasks from parent tasks+- Implement analyze-complexity MCP command for analyzing task complexity and generating recommendations- Document MCP server naming conventions in architecture.mdc and mcp.mdc files (file names use kebab-case, direct functions use camelCase with Direct suffix, tool registration functions use camelCase with Tool suffix, and MCP tool names use snake_case)diff --git a/mcp-server/src/core/direct-functions/analyze-task-complexity.js b/mcp-server/src/core/direct-functions/analyze-task-complexity.jsnew file mode 100644index 00000000..c8f42e28--- /dev/null+++ b/mcp-server/src/core/direct-functions/analyze-task-complexity.js@@ -0,0 +1,91 @@+/**+ * Direct function wrapper for analyzeTaskComplexity+ */++import { analyzeTaskComplexity } from '../../../../scripts/modules/task-manager.js';+import { findTasksJsonPath } from '../utils/path-utils.js';+import fs from 'fs';+import path from 'path';++/**+ * Analyze task complexity and generate recommendations+ * @param {Object} args - Function arguments+ * @param {string} [args.file] - Path to the tasks file+ * @param {string} [args.output] - Output file path for the report+ * @param {string} [args.model] - LLM model to use for analysis+ * @param {string|number} [args.threshold] - Minimum complexity score to recommend expansion (1-10)+ * @param {boolean} [args.research] - Use Perplexity AI for research-backed complexity analysis+ * @param {string} [args.projectRoot] - Project root directory+ * @param {Object} log - Logger object+ * @returns {Promise<{success: boolean, data?: Object, error?: {code: string, message: string}}>}+ */+export async function analyzeTaskComplexityDirect(args, log) {+ try {+ log.info(`Analyzing task complexity with args: ${JSON.stringify(args)}`);++ // Find the tasks.json path+ const tasksPath = findTasksJsonPath(args.file, args.projectRoot);++ // Determine output path+ let outputPath = args.output || 'scripts/task-complexity-report.json';+ if (!path.isAbsolute(outputPath) && args.projectRoot) {+ outputPath = path.join(args.projectRoot, outputPath);+ }++ // Create options object for analyzeTaskComplexity+ const options = {+ file: tasksPath,+ output: outputPath,+ model: args.model,+ threshold: args.threshold,+ research: args.research === true+ };++ log.info(`Analyzing task complexity from: ${tasksPath}`);+ log.info(`Output report will be saved to: ${outputPath}`);++ if (options.research) {+ log.info('Using Perplexity AI for research-backed complexity analysis');+ }++ // Call the core function+ await analyzeTaskComplexity(options);++ // Verify the report file was created+ if (!fs.existsSync(outputPath)) {+ return {+ success: false,+ error: {+ code: 'ANALYZE_ERROR',+ message: 'Analysis completed but no report file was created'+ }+ };+ }++ // Read the report file+ const report = JSON.parse(fs.readFileSync(outputPath, 'utf8'));++ return {+ success: true,+ data: {+ message: `Task complexity analysis complete. Report saved to ${outputPath}`,+ reportPath: outputPath,+ reportSummary: {+ taskCount: report.length,+ highComplexityTasks: report.filter(t => t.complexityScore >= 8).length,+ mediumComplexityTasks: report.filter(t => t.complexityScore >= 5 && t.complexityScore < 8).length,+ lowComplexityTasks: report.filter(t => t.complexityScore < 5).length,+ }+ }+ };+ } catch (error) {+ log.error(`Error in analyzeTaskComplexityDirect: ${error.message}`);+ return {+ success: false,+ error: {+ code: 'CORE_FUNCTION_ERROR',+ message: error.message+ }+ };+ }+}\ 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 b0320656..d524943a 100644--- a/mcp-server/src/core/task-master-core.js+++ b/mcp-server/src/core/task-master-core.js@@ -19,6 +19,7 @@ import { expandTaskDirect } from './direct-functions/expand-task.js';import { addTaskDirect } from './direct-functions/add-task.js';import { addSubtaskDirect } from './direct-functions/add-subtask.js';import { removeSubtaskDirect } from './direct-functions/remove-subtask.js';+import { analyzeTaskComplexityDirect } from './direct-functions/analyze-task-complexity.js';// Re-export utility functionsexport { findTasksJsonPath } from './utils/path-utils.js';@@ -38,7 +39,8 @@ export const directFunctions = new Map([['expandTaskDirect', expandTaskDirect],['addTaskDirect', addTaskDirect],['addSubtaskDirect', addSubtaskDirect],- ['removeSubtaskDirect', removeSubtaskDirect]+ ['removeSubtaskDirect', removeSubtaskDirect],+ ['analyzeTaskComplexityDirect', analyzeTaskComplexityDirect]]);// Re-export all direct function implementations@@ -56,5 +58,6 @@ export {expandTaskDirect,addTaskDirect,addSubtaskDirect,- removeSubtaskDirect+ removeSubtaskDirect,+ analyzeTaskComplexityDirect};\ No newline at end of filediff --git a/mcp-server/src/tools/analyze.js b/mcp-server/src/tools/analyze.jsnew file mode 100644index 00000000..2fc35581--- /dev/null+++ b/mcp-server/src/tools/analyze.js@@ -0,0 +1,52 @@+/**+ * tools/analyze.js+ * Tool for analyzing task complexity and generating recommendations+ */++import { z } from "zod";+import {+ handleApiResult,+ createErrorResponse+} from "./utils.js";+import { analyzeTaskComplexityDirect } from "../core/task-master-core.js";++/**+ * Register the analyze tool with the MCP server+ * @param {Object} server - FastMCP server instance+ */+export function registerAnalyzeTool(server) {+ server.addTool({+ name: "analyze_project_complexity",+ description: "Analyze task complexity and generate expansion recommendations",+ parameters: z.object({+ output: z.string().optional().describe("Output file path for the report (default: scripts/task-complexity-report.json)"),+ model: z.string().optional().describe("LLM model to use for analysis (defaults to configured model)"),+ threshold: z.union([z.number(), z.string()]).optional().describe("Minimum complexity score to recommend expansion (1-10) (default: 5)"),+ file: z.string().optional().describe("Path to the tasks file (default: tasks/tasks.json)"),+ research: z.boolean().optional().describe("Use Perplexity AI for research-backed complexity analysis"),+ projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)")+ }),+ execute: async (args, { log }) => {+ try {+ log.info(`Analyzing task complexity with args: ${JSON.stringify(args)}`);++ // Call the direct function wrapper+ const result = await analyzeTaskComplexityDirect(args, log);++ // Log result+ if (result.success) {+ log.info(`Task complexity analysis complete: ${result.data.message}`);+ log.info(`Report summary: ${JSON.stringify(result.data.reportSummary)}`);+ } else {+ log.error(`Failed to analyze task complexity: ${result.error.message}`);+ }++ // Use handleApiResult to format the response+ return handleApiResult(result, log, 'Error analyzing task complexity');+ } catch (error) {+ log.error(`Error in analyze 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 e4ebd615..fe719457 100644--- a/mcp-server/src/tools/index.js+++ b/mcp-server/src/tools/index.js@@ -17,6 +17,7 @@ import { registerExpandTaskTool } from "./expand-task.js";import { registerAddTaskTool } from "./add-task.js";import { registerAddSubtaskTool } from "./add-subtask.js";import { registerRemoveSubtaskTool } from "./remove-subtask.js";+import { registerAnalyzeTool } from "./analyze.js";/*** Register all Task Master tools with the MCP server@@ -36,6 +37,7 @@ export function registerTaskMasterTools(server) {registerAddTaskTool(server);registerAddSubtaskTool(server);registerRemoveSubtaskTool(server);+ registerAnalyzeTool(server);logger.info("Registered all Task Master tools with MCP server");}diff --git a/tasks/task_023.txt b/tasks/task_023.txtindex 8dcb861c..db9c4d7c 100644--- a/tasks/task_023.txt+++ b/tasks/task_023.txt@@ -703,7 +703,7 @@ Following MCP implementation standards:- Unit test for removeSubtaskDirect.js- Integration test for MCP tool-## 28. Implement analyze MCP command [pending]+## 28. Implement analyze MCP command [done]### Dependencies: None### Description: Create direct function wrapper and MCP tool for analyzing task complexity.### Details:diff --git a/tasks/tasks.json b/tasks/tasks.jsonindex 3d81d42f..f6014f8e 100644--- a/tasks/tasks.json+++ b/tasks/tasks.json@@ -1600,7 +1600,7 @@"title": "Implement analyze MCP command","description": "Create direct function wrapper and MCP tool for analyzing task complexity.","details": "Following MCP implementation standards:\n\n1. Create analyzeTaskComplexityDirect.js in mcp-server/src/core/direct-functions/:\n - Import analyzeTaskComplexity from task-manager.js\n - Handle file paths using findTasksJsonPath utility\n - Process arguments: taskId\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 analyze.js MCP tool in mcp-server/src/tools/:\n - Import z from zod for parameter schema\n - Import executeMCPToolAction from ./utils.js\n - Import analyzeTaskComplexityDirect from task-master-core.js\n - Define parameters matching CLI options using zod schema\n - Implement registerAnalyzeTool(server) with server.addTool\n - Use executeMCPToolAction in execute method\n\n4. Register in tools/index.js with tool name 'analyze'\n\n5. Add to .cursor/mcp.json with appropriate schema\n\n6. Write tests following testing guidelines:\n - Unit test for analyzeTaskComplexityDirect.js\n - Integration test for MCP tool",- "status": "pending",+ "status": "done","dependencies": [],"parentTaskId": 23},