grok-faf-mcp

Instructions

Implementation Reference

• src/handlers/tools.ts:656-695 (handler)

  The handleFafEnhance function executes the tool logic, processing arguments and calling the engineAdapter to perform the enhancement.

  private async handleFafEnhance(args: any): Promise<CallToolResult> {
    const enhanceArgs: string[] = [];
  
    // Default to Claude optimization if no model specified
    const model = args?.model || 'claude';
    enhanceArgs.push('--model', model);
  
    if (args?.focus) {
      enhanceArgs.push('--focus', args.focus);
    }
    if (args?.consensus) {
      enhanceArgs.push('--consensus');
    }
    if (args?.dryRun) {
      enhanceArgs.push('--dry-run');
    }
  
    const result = await this.engineAdapter.callEngine('enhance', enhanceArgs);
  
    if (!result.success) {
      return {
        content: [{
          type: 'text',
          text: `🚀 Claude FAF Enhancement:\n\nFailed to enhance: ${result.error}`
        }],
        isError: true
      };
    }
  
    const output = typeof result.data === 'string'
      ? result.data
      : result.data?.output || JSON.stringify(result.data, null, 2);
  
    return {
      content: [{
        type: 'text',
        text: `🚀 Claude FAF Enhancement:\n\n${output}`
      }]
    };
  }

• src/handlers/tools.ts:82-93 (schema)

  Definition of the faf_enhance tool schema, including parameters like model and focus.

    name: 'faf_enhance',
    description: 'Enhance .faf with AI optimization',
    inputSchema: {
      type: 'object',
      properties: {
        model: { type: 'string', description: 'Target AI model: claude|chatgpt|gemini|universal (default: claude)' },
        focus: { type: 'string', description: 'Enhancement focus: claude-optimal|human-context|ai-instructions|completeness' },
        consensus: { type: 'boolean', description: 'Build consensus from multiple AI models' },
        dryRun: { type: 'boolean', description: 'Preview enhancement without applying changes' }
      },
    }
  },

• src/handlers/tool-types.ts:76-79 (schema)

  TypeScript interface definition for FafEnhance arguments.

  export interface FafEnhanceArgs {
    model?: string;
    focus?: string;
  }

• src/handlers/tools.ts:270-271 (registration)

  Registration/routing for faf_enhance within the tool handler switch-case.

  case 'faf_enhance':
    return await this.handleFafEnhance(args);