← Index

io.github.hampsterx/codex-mcp-bridge

io.github.hampsterx/codex-mcp-bridge·v0.5.1·Search
Quality Score
80
/100

Wraps Codex CLI as MCP tools: query, review, search, assess, structured, sessions.

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "codex-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "codex-mcp-bridge"
      ],
      "env": {
        "CODEX_CLI_PATH": "codex",
        "CODEX_DEFAULT_MODEL": "<codex_default_model>",
        "CODEX_FALLBACK_MODEL": "<codex_fallback_model>",
        "CODEX_MAX_CONCURRENT": "3",
        "CODEX_MCP_SERVERS": "<codex_mcp_servers>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "codex-mcp-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "codex-mcp-bridge"
      ],
      "env": {
        "CODEX_CLI_PATH": "codex",
        "CODEX_DEFAULT_MODEL": "<codex_default_model>",
        "CODEX_FALLBACK_MODEL": "<codex_fallback_model>",
        "CODEX_MAX_CONCURRENT": "3",
        "CODEX_MCP_SERVERS": "<codex_mcp_servers>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y codex-mcp-bridge
§02  Environment variables
CODEX_CLI_PATH

Path to the codex CLI binary. Defaults to 'codex' on PATH.

CODEX_DEFAULT_MODEL

Default Codex model for query/review/search.

CODEX_FALLBACK_MODEL

Model to use when the primary model hits a quota error.

CODEX_MAX_CONCURRENT

Maximum concurrent Codex CLI subprocesses (default 3).

CODEX_MCP_SERVERS

Controls which MCP servers from ~/.codex/config.toml stay enabled inside the Codex subprocess. Empty/unset disables all non-required servers; 'inherit' passes config through; comma-separated names (e.g. 'serena,github') enables those; values starting with '{' or '[' are raw TOML.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
5
§04  Alternatives in Search