codex-mcp-http-bridge

# Codex MCP HTTP Bridge A Python package that enables OpenAI Codex to connect to remote MCP (Model Context Protocol) servers via HTTPS with OAuth 2.1 authentication. ## Features - **stdio to HTTP Bridge**: Converts Codex's stdio MCP protocol to HTTP requests - **OAuth 2.1 Authentication**: Secure authentication using Bearer tokens - **Long-lived Tokens**: Personal access tokens that last up to 1 year - **Multiple Servers**: Configure and connect to multiple remote MCP servers - **Easy Setup**: Interactive CLI wizard for configuration - **Comprehensive Logging**: Debug connectivity issues with detailed logs ## Installation ```bash pip install codex-mcp-http-bridge ``` Or install from source: ```bash git clone https://github.com/gurucloudai/codex-mcp-http-bridge.git cd codex-mcp-http-bridge pip install -e . ``` ## Quick Start ### 1. Generate a Personal Access Token First, generate a personal access token from your MCP server provider (e.g., GuruCloudAI): ```bash # Log into https://www.gurucloudai.com # Navigate to MCP Manager # Click "Generate Token" or use the API: curl -X POST https://www.gurucloudai.com/api/personal-access-tokens \ -H "Authorization: Bearer YOUR_SESSION_TOKEN" \ -H "Content-Type: application/json" \ -d '{"name": "Codex Bridge Token"}' ``` ### 2. Configure the Bridge Run the interactive setup wizard: ```bash codex-mcp-http-bridge setup ``` This will guide you through: - Adding your MCP server URL - Entering your personal access token - Configuring multiple servers (optional) Configuration is saved to `~/.codex-mcp-bridge/config.json` with secure permissions (chmod 600). ### 3. Test the Connection ```bash codex-mcp-http-bridge test --server my-knowledge-base ``` ### 4. Generate Codex Configuration ```bash codex-mcp-http-bridge codex-config >> ~/.codex/config.toml ``` ### 5. Restart Codex Restart Codex to load the new MCP servers. Your remote servers will now be available to Codex! ## Configuration ### Manual Configurati…