Review MCP Server

Instructions

Implementation Reference

• src/index.ts:271-288 (handler)

  The main handler function for the "review_code" MCP tool. It validates input arguments, ensures code is provided, invokes the shared review performance logic, and returns formatted review feedback.
  private async handleReviewCode(args: CodeReviewRequest) { const { code, context, reviewers = ["both"] } = args; if (!code) { throw new Error("Code is required"); } const reviews = await this.performReview(code, context, reviewers); return { content: [ { type: "text", text: this.formatReviews(reviews), }, ], }; }
• src/index.ts:191-212 (schema)

  JSON Schema defining the input parameters for the "review_code" tool, including required 'code' field and optional 'context' and 'reviewers'.
  inputSchema: { type: "object", properties: { code: { type: "string", description: "The code to review", }, context: { type: "string", description: "Additional context about the code (optional)", }, reviewers: { type: "array", items: { type: "string", enum: ["codex", "gemini", "both"], }, description: "Which reviewers to use (default: both)", }, }, required: ["code"], },
• src/index.ts:187-213 (registration)

  Tool registration in the getTools() method, defining name, description, and inputSchema for the MCP tools list.
  { name: "review_code", description: "Request a code review from Codex and Gemini CLIs. Provide code directly as a string. Returns feedback from both reviewers for Claude to consider.", inputSchema: { type: "object", properties: { code: { type: "string", description: "The code to review", }, context: { type: "string", description: "Additional context about the code (optional)", }, reviewers: { type: "array", items: { type: "string", enum: ["codex", "gemini", "both"], }, description: "Which reviewers to use (default: both)", }, }, required: ["code"], }, },
• src/index.ts:107-108 (registration)

  Dispatch case in the CallToolRequestSchema handler that routes "review_code" calls to the specific handleReviewCode method.
  case "review_code": return await this.handleReviewCode(args as CodeReviewRequest);
• src/index.ts:383-426 (helper)

  Core helper method that performs the actual code review by calling available CLI tools (Codex/OpenAI and/or Gemini), validates responses, and collects feedback from selected reviewers.
  private async performReview( code: string, context: string | undefined, reviewers: string[] ): Promise<Record<string, string>> { const reviews: Record<string, string> = {}; const useCodex = (reviewers.includes("codex") || reviewers.includes("both")) && this.cliAvailability.codex; const useGemini = (reviewers.includes("gemini") || reviewers.includes("both")) && this.cliAvailability.gemini; // If no CLIs are available, provide a helpful message if (!this.cliAvailability.codex && !this.cliAvailability.gemini) { reviews.info = "⚠️ No review CLIs are currently available. Please install OpenAI CLI and/or Gemini CLI to enable code reviews.\n\n" + "Check status with the check_cli_status tool."; return reviews; } const reviewPrompt = this.buildReviewPrompt(code, context); const reviewPromises: Promise<void>[] = []; if (useCodex) { reviewPromises.push( this.getCodexReview(reviewPrompt).then((review) => { reviews.codex = review; }) ); } else if (reviewers.includes("codex")) { reviews.codex = "⚠️ Codex review requested but OpenAI CLI is not available."; } if (useGemini) { reviewPromises.push( this.getGeminiReview(reviewPrompt).then((review) => { reviews.gemini = review; }) ); } else if (reviewers.includes("gemini")) { reviews.gemini = "⚠️ Gemini review requested but Gemini CLI is not available."; } await Promise.all(reviewPromises); return reviews; }