# Code Review MCP

Global Codex plugin that exposes MCP tools for Codex-powered Git code review.

## Tools

- `collect_git_diff`: returns `git diff --name-status` and `git diff --stat` for a repository range.
- `review_git_changes`: collects the diff overview, asks `codex exec` to inspect detailed changes with read-only Git commands, returns a Chinese Markdown review, and optionally sends a Feishu interactive card.

## Main Arguments

| Argument | Required | Description |
| --- | --- | --- |
| `workspace` | Yes | Local Git repository path. |
| `baseSha` | Yes | Base commit for `baseSha..headSha`. |
| `headSha` | No | Head commit. Defaults to `HEAD`. |
| `feishuWebhook` | No | Feishu custom bot webhook. If omitted, no notification is sent. |
| `codexCommand` | No | Codex executable. Defaults to `codex`. |
| `codexModel` | No | Optional model passed to `codex exec --model`. |
| `modelApiKey` | No | Optional API key used in a temporary Codex home for this run. |
| `modelApiBaseUrl` | No | OpenAI-compatible base URL for the temporary Codex config. |

The tool creates a temporary read-oriented Git wrapper for the nested Codex process. It allows review commands such as `git diff`, `git show`, `git status`, and `git ls-files`, and blocks write or remote update commands such as `git push`, `git commit`, and unsupported Git subcommands.

When `modelApiKey` is supplied, this plugin writes `config.toml` and `auth.json` under a temporary `CODEX_HOME` for the review process only. It does not replace the user's existing `~/.codex` files.