Reviewer MCP

Instructions

Implementation Reference

• src/tools/generateSpec.ts:5-33 (handler)

  Core handler implementation for 'generate_spec' tool. The GenerateSpecTool class defines the AI prompts and action name. The exported generateSpec function executes the tool.

  class GenerateSpecTool extends BaseAITool<SpecGenerationOptions> {
    protected getActionName(): string {
      return 'generating specification';
    }
  
    protected getSystemPrompt(args: SpecGenerationOptions): string {
      const { format = 'markdown' } = args;
      return `You are a technical specification writer. Generate detailed, clear, and actionable specifications based on the requirements provided. 
  ${format === 'structured' ? 'Output in a structured format with clear sections, requirements, and acceptance criteria.' : 'Output in clean markdown format.'}
  Focus on:
  - Clear objectives and goals
  - Detailed requirements (functional and non-functional)
  - Technical architecture and design decisions
  - Implementation approach
  - Success criteria and testing requirements
  - Edge cases and error handling`;
    }
  
    protected getUserPrompt(args: SpecGenerationOptions): string {
      const { prompt, context } = args;
      return `Generate a specification for: ${prompt}${context ? `\n\nAdditional context: ${context}` : ''}`;
    }
  }
  
  const tool = new GenerateSpecTool();
  
  export async function generateSpec(args: SpecGenerationOptions): Promise<CallToolResult> {
    return tool.execute(args);
  }

• src/index.ts:29-41 (registration)

  Registers the 'generate_spec' MCP tool with input schema and handler reference.

  // Register generate_spec tool
  server.registerTool(
    'generate_spec',
    {
      description: 'Generate a specification document using OpenAI O3 model',
      inputSchema: {
        prompt: z.string().describe('Description of what specification to generate'),
        context: z.string().optional().describe('Additional context or requirements'),
        format: z.enum(['markdown', 'structured']).optional().default('markdown').describe('Output format for the specification'),
      },
    },
    async (args) => generateSpec(args)
  );

• src/types/index.ts:33-37 (schema)

  Type definition for input parameters of the generate_spec tool, matching the Zod schema.

  export interface SpecGenerationOptions {
    prompt: string;
    context?: string;
    format?: 'markdown' | 'structured';
  }