MCP Mobile Server

Instructions

Implementation Reference

• src/tools/super-tools.ts:255-308 (handler)

  Main execution logic for flutter_test_suite: composes flutter_test for unit/widget tests, runs integration tests directly, generates HTML coverage report.

  handler: async (args: any) => {
    const results = {
      unit: null as any,
      widget: null as any,
      integration: null as any,
      coverage: null as any
    };
    
    try {
      // Run unit and widget tests
      const testTool = flutterTools.get('flutter_test');
      results.unit = await testTool.handler({
        cwd: args.cwd,
        coverage: args.coverage
      });
      
      // Run integration tests if requested
      if (args.integrationTests) {
        const { stdout } = await processExecutor.execute(
          'flutter',
          ['test', 'integration_test'],
          { cwd: args.cwd }
        );
        results.integration = { success: true, data: stdout };
      }
      
      // Generate coverage report
      if (args.coverage) {
        const { stdout } = await processExecutor.execute(
          'genhtml',
          ['coverage/lcov.info', '-o', 'coverage/html'],
          { cwd: args.cwd }
        );
        results.coverage = { 
          success: true, 
          data: { 
            htmlReport: 'coverage/html/index.html',
            lcovFile: 'coverage/lcov.info'
          }
        };
      }
      
      return {
        success: true,
        data: results
      };
    } catch (error) {
      return {
        success: false,
        error: error instanceof Error ? error.message : String(error),
        data: results
      };
    }
  }

• src/tools/super-tools.ts:235-254 (schema)

  Input validation schema defining parameters for the flutter_test_suite tool.

  inputSchema: {
    type: 'object',
    properties: {
      cwd: {
        type: 'string',
        description: 'Working directory (Flutter project root)'
      },
      coverage: {
        type: 'boolean',
        description: 'Generate coverage report',
        default: true
      },
      integrationTests: {
        type: 'boolean',
        description: 'Include integration tests',
        default: false
      }
    },
    required: ['cwd']
  },

• src/tools/super-tools.ts:231-309 (registration)

  Registration of the flutter_test_suite tool in the super-tools map created by createSuperTools.

  // Flutter Test Suite - Complete testing workflow
  tools.set('flutter_test_suite', {
    name: 'flutter_test_suite', 
    description: 'Run complete test suite: unit tests, widget tests, integration tests with coverage report',
    inputSchema: {
      type: 'object',
      properties: {
        cwd: {
          type: 'string',
          description: 'Working directory (Flutter project root)'
        },
        coverage: {
          type: 'boolean',
          description: 'Generate coverage report',
          default: true
        },
        integrationTests: {
          type: 'boolean',
          description: 'Include integration tests',
          default: false
        }
      },
      required: ['cwd']
    },
    handler: async (args: any) => {
      const results = {
        unit: null as any,
        widget: null as any,
        integration: null as any,
        coverage: null as any
      };
      
      try {
        // Run unit and widget tests
        const testTool = flutterTools.get('flutter_test');
        results.unit = await testTool.handler({
          cwd: args.cwd,
          coverage: args.coverage
        });
        
        // Run integration tests if requested
        if (args.integrationTests) {
          const { stdout } = await processExecutor.execute(
            'flutter',
            ['test', 'integration_test'],
            { cwd: args.cwd }
          );
          results.integration = { success: true, data: stdout };
        }
        
        // Generate coverage report
        if (args.coverage) {
          const { stdout } = await processExecutor.execute(
            'genhtml',
            ['coverage/lcov.info', '-o', 'coverage/html'],
            { cwd: args.cwd }
          );
          results.coverage = { 
            success: true, 
            data: { 
              htmlReport: 'coverage/html/index.html',
              lcovFile: 'coverage/lcov.info'
            }
          };
        }
        
        return {
          success: true,
          data: results
        };
      } catch (error) {
        return {
          success: false,
          error: error instanceof Error ? error.message : String(error),
          data: results
        };
      }
    }
  });

• src/tools/flutter.ts:720-785 (helper)

  Supporting flutter_test tool used by flutter_test_suite for running unit and widget tests.

  tools.set('flutter_test', {
    name: 'flutter_test',
    description: 'Run Flutter tests with optional coverage',
    inputSchema: {
      type: 'object',
      properties: {
        cwd: { type: 'string', minLength: 1, description: 'Working directory (Flutter project root)' },
        testFile: { type: 'string', description: 'Specific test file to run (optional)' },
        coverage: { type: 'boolean', description: 'Enable test coverage' }
      },
      required: ['cwd']
    },
    handler: async (args: any) => {
      const validation = FlutterTestSchema.safeParse(args);
      if (!validation.success) {
        throw new Error(`Invalid request: ${validation.error.message}`);
      }
  
      const { cwd, testFile, coverage = false } = validation.data;
  
      // Validate that it's a Flutter project
      await validateFlutterProject(cwd);
  
      const flutter_args = ['test'];
      
      if (testFile) {
        // Validate test file path (must be .dart file in test directory)
        if (!testFile.endsWith('.dart')) {
          throw new Error(`Test file must be a .dart file. Invalid test file: ${testFile}`);
        }
        
        // Check if test file exists
        const testFilePath = path.isAbsolute(testFile) ? testFile : path.join(cwd, testFile);
        try {
          await fs.access(testFilePath);
        } catch {
          throw new Error(`Test file not found. File does not exist: ${testFilePath}`);
        }
        
        flutter_args.push(testFile);
      }
      
      if (coverage) {
        flutter_args.push('--coverage');
      }
  
      const result = await processExecutor.execute('flutter', flutter_args, {
        cwd,
        timeout: 600000, // 10 minutes timeout for tests
      });
  
      return {
        success: true,
        data: {
          testFile: testFile || 'all tests',
          coverage,
          projectPath: cwd,
          exitCode: result.exitCode,
          output: result.stdout,
          errors: result.stderr,
          duration: result.duration,
          passed: result.exitCode === 0,
        },
      };
    }
  });

• src/server.ts:61-71 (registration)

  Top-level registration loop that adds superTools (including flutter_test_suite) to the main MCP tools map if present in TOOL_REGISTRY.

  for (const toolName of Object.keys(TOOL_REGISTRY)) {
    if (allAvailableTools.has(toolName)) {
      tools.set(toolName, allAvailableTools.get(toolName));
    } else if (toolName === 'health_check') {
      // health_check is handled separately below
      continue;
    } else {
      // Tool is in registry but not implemented - log warning
      console.warn(`Warning: Tool '${toolName}' is in TOOL_REGISTRY but not implemented`);
    }
  }