{"id":"elyin-codex-bridge","name":"codex-bridge","homepage":null,"repo_url":"https://github.com/eLyiN/codex-bridge","category":"devtools","subcategories":[],"tags":["mcp","codex","openai","ai-coding-assistant","cli-bridge","python","tooling"],"what_it_does":"Provides an MCP server that exposes two Codex-related tools to MCP-compatible coding assistants, bridging tool calls to the official OpenAI Codex CLI via subprocess execution. Supports configurable timeouts and (optionally) bypassing Codex CLI git-repository checks.","use_cases":["Integrate Codex CLI with MCP clients like Claude Code, Cursor, and VS Code","Have an agent answer coding/architecture questions using Codex via a standardized MCP interface","Perform targeted file analysis by piping file contents to Codex","Batch multiple Codex queries for automation/CI-style workflows"],"not_for":["Directly calling Codex/OpenAI APIs over HTTP from your application (this is CLI-first)","Use cases requiring fine-grained model/provider controls beyond what the Codex CLI supports","Untrusted/hostile directory analysis without controls (git check bypass can increase risk)"],"best_when":"You already use the official Codex CLI and want MCP-tool access for local/agent workflows with minimal integration overhead.","avoid_when":"You cannot control the working directory contents or trust boundaries (especially when disabling git checks).","alternatives":["Use Codex CLI directly without an MCP bridge","Implement an MCP server that calls an OpenAI API directly (HTTP) instead of the CLI","Use other existing MCP bridges for OpenAI/Code models"],"af_score":60.5,"security_score":60.8,"reliability_score":37.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:49:03.620881+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Local Codex CLI authentication (e.g., via `codex` / `codex auth login`)"],"oauth":false,"scopes":false,"notes":"Authentication is delegated to the external Codex CLI; the MCP server itself primarily passes through CLI execution and relies on CLI auth state."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"README claims 'Zero API costs' by using the official Codex CLI; however, actual Codex CLI/model usage may still incur provider costs outside this package."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":60.5,"security_score":60.8,"reliability_score":37.5,"mcp_server_quality":70.0,"documentation_accuracy":75.0,"error_message_quality":null,"error_message_notes":"README mentions 'robust error handling' and common error messages (CLI not available, authentication required, timeout). Specific MCP error codes/structured schemas are not shown in the provided content.","auth_complexity":60.0,"rate_limit_clarity":20.0,"tls_enforcement":90.0,"auth_strength":55.0,"scope_granularity":30.0,"dependency_hygiene":60.0,"secret_handling":70.0,"security_notes":"Security model is largely inherited from the external Codex CLI and MCP host environment. Bridge uses environment variables for timeouts and a git-check bypass flag; README warns about trusting directories when skipping checks. No explicit secrets management, logging behavior, or scope/least-privilege controls are documented in the provided content.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":40.0,"error_recovery":55.0,"idempotency_support":"false","idempotency_notes":"Operations are stateless but tool calls trigger external CLI executions; no explicit idempotency guarantees or request identifiers are described.","pagination_style":"none","retry_guidance_documented":true,"known_agent_gotchas":["Relies on `codex` CLI being installed and authenticated; tool calls will fail if CLI is missing or not in PATH","Timeouts are enforced (default 90s); large inputs may require increasing `CODEX_TIMEOUT`","If `CODEX_SKIP_GIT_CHECK` is enabled, it should only be used in trusted directories you control"]}}