Review MCP Server

Instructions

Implementation Reference

• src/index.ts:314-342 (handler)

  Primary handler for 'review_directory' tool: recursively finds code files in directory, reviews each with Codex/Gemini CLIs, collects and formats feedback.
  private async handleReviewDirectory(args: CodeReviewRequest) { const { directory, context, reviewers = ["both"] } = args; if (!directory) { throw new Error("Directory path is required"); } const files = await this.getCodeFiles(directory); const allReviews: Array<{ file: string; reviews: Record<string, string> }> = []; for (const file of files) { const code = await fs.readFile(file, "utf-8"); const reviews = await this.performReview( code, `File: ${file}\n${context || ""}`, reviewers ); allReviews.push({ file, reviews }); } return { content: [ { type: "text", text: this.formatDirectoryReviews(allReviews), }, ], }; }
• src/index.ts:241-267 (registration)

  Tool registration in getTools(): defines name, description, and inputSchema for 'review_directory'.
  { name: "review_directory", description: "Request a code review of all files in a directory from Codex and Gemini CLIs. Returns feedback from both reviewers for Claude to consider.", inputSchema: { type: "object", properties: { directory: { type: "string", description: "Path to the directory 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: ["directory"], }, },
• src/index.ts:17-23 (schema)

  TypeScript interface for input args to review tools, including 'directory' for review_directory.
  interface CodeReviewRequest { filePath?: string; directory?: string; code?: string; reviewers?: string[]; context?: string; }
• src/index.ts:344-360 (helper)

  Helper to recursively collect paths of code files (by extension) in a directory, used by handleReviewDirectory.
  private async getCodeFiles(directory: string): Promise<string[]> { const files: string[] = []; const entries = await fs.readdir(directory, { withFileTypes: true }); for (const entry of entries) { const fullPath = path.join(directory, entry.name); if (entry.isDirectory()) { if (!entry.name.startsWith(".") && entry.name !== "node_modules") { files.push(...(await this.getCodeFiles(fullPath))); } } else if (this.isCodeFile(entry.name)) { files.push(fullPath); } } return files; }
• src/index.ts:678-705 (helper)

  Helper to format review results for multiple files in a directory.
  private formatDirectoryReviews( allReviews: Array<{ file: string; reviews: Record<string, string> }> ): string { let output = "# Directory Code Review Feedback\n\n"; output += "Claude, please consider this feedback from other AI reviewers:\n\n"; for (const { file, reviews } of allReviews) { output += `## File: ${file}\n\n`; if (reviews.codex) { output += "### Codex Review\n\n"; output += reviews.codex; output += "\n\n"; } if (reviews.gemini) { output += "### Gemini Review\n\n"; output += reviews.gemini; output += "\n\n"; } output += "---\n\n"; } output += "Please analyze this feedback and provide your own assessment of the codebase."; return output; }