codex-gemini-bridge

中文说明

A lightweight, zero-dependency MCP server that connects OpenAI Codex to Gemini models via your local Antigravity CLI (agy).

Supports macOS, Linux, and Windows.

1. Prerequisites

1. Node.js: >= 22.0.0 (node --version)

2. Antigravity CLI (agy):

   • Install agy from the official installation guide.

   • Authenticate with Google:

     agy auth login
     agy models

Related MCP server: Gemini Bridge

2. Quick Install & Auto-Config (Recommended)

Run the one-liner setup command for your operating system. It downloads the project to ~/.codex/mcp-servers/codex-gemini-bridge and automatically configures Codex (~/.codex/config.toml):

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/theotherkim/codex-gemini-bridge/main/scripts/setup.sh)

Windows (PowerShell)

irm https://raw.githubusercontent.com/theotherkim/codex-gemini-bridge/main/scripts/setup.ps1 | iex

(If you already cloned the repo locally, simply run npm run setup inside the project directory).

3. Manual Configuration (Optional)

If you prefer to configure manually, clone the repository into your Codex MCP directory:

macOS / Linux

git clone https://github.com/theotherkim/codex-gemini-bridge.git ~/.codex/mcp-servers/codex-gemini-bridge

Add to ~/.codex/config.toml:

[mcp_servers.codex-gemini-bridge]
command = "node"
args = ["~/.codex/mcp-servers/codex-gemini-bridge/src/index.mjs"]
env_vars = ["AGY_BIN"]

(Or via Codex CLI: codex mcp add codex-gemini-bridge -- node ~/.codex/mcp-servers/codex-gemini-bridge/src/index.mjs)

Windows

git clone https://github.com/theotherkim/codex-gemini-bridge.git "$env:USERPROFILE\.codex\mcp-servers\codex-gemini-bridge"

Add to %USERPROFILE%\.codex\config.toml:

[mcp_servers.codex-gemini-bridge]
command = "node"
args = ["C:/Users/<YourUsername>/.codex/mcp-servers/codex-gemini-bridge/src/index.mjs"]
env_vars = ["AGY_BIN"]

4. Usage

Restart Codex, then ask in natural language:

• "Ask Gemini to summarize this codebase"

• "Use Gemini to review this pull request"

• "List available models with gemini_models"

Available Tools

• gemini: Send prompts to Gemini (supports prompt, model, thinking_level, store, etc.).

• gemini_models: List all models available to your local account.

License

MIT © Kim