fix: Improve MCP server robustness and debugging

- Refactor  for more reliable project root detection, particularly when running within integrated environments like Cursor IDE. Includes deriving root from script path and avoiding fallback to '/'.
- Enhance error handling in :
    - Add detailed debug information (paths searched, CWD, etc.) to the error message when  is not found in the provided project root.
    - Improve clarity of error messages and potential solutions.
- Add verbose logging in  to trace session object content and the finally resolved project root path, aiding in debugging path-related issues.
- Add default values for  and  to the example  environment configuration.

mcp-server/src/tools/complexity-report.js

@@ -6,7 +6,8 @@
 import { z } from "zod";
 import {
   handleApiResult,
-  createErrorResponse
+  createErrorResponse,
+  getProjectRootFromSession
 } from "./utils.js";
 import { complexityReportDirect } from "../core/task-master-core.js";
 
@@ -22,21 +23,31 @@ export function registerComplexityReportTool(server) {
       file: z.string().optional().describe("Path to the report file (default: scripts/task-complexity-report.json)"),
       projectRoot: z.string().optional().describe("Root directory of the project (default: current working directory)")
     }),
-    execute: async (args, { log }) => {
+    execute: async (args, { log, session, reportProgress }) => {
       try {
         log.info(`Getting complexity report with args: ${JSON.stringify(args)}`);
+        await reportProgress({ progress: 0 });
         
-        // Call the direct function wrapper
-        const result = await complexityReportDirect(args, log);
+        let rootFolder = getProjectRootFromSession(session, log);
+        
+        if (!rootFolder && args.projectRoot) {
+          rootFolder = args.projectRoot;
+          log.info(`Using project root from args as fallback: ${rootFolder}`);
+        }
+        
+        const result = await complexityReportDirect({
+          projectRoot: rootFolder,
+          ...args
+        }, log, { reportProgress, mcpLog: log, session});
+        
+        await reportProgress({ progress: 100 });
         
-        // Log result
         if (result.success) {
           log.info(`Successfully retrieved complexity report${result.fromCache ? ' (from cache)' : ''}`);
         } else {
           log.error(`Failed to retrieve complexity report: ${result.error.message}`);
         }
         
-        // Use handleApiResult to format the response
         return handleApiResult(result, log, 'Error retrieving complexity report');
       } catch (error) {
         log.error(`Error in complexity-report tool: ${error.message}`);