Codex MCP Wrapper

An MCP server that wraps the OpenAI Codex CLI, exposing its functionality through the MCP API.

This project wraps OpenAI's Codex CLI as an MCP (Model Context Protocol) server, making it accessible through the TeaBranch/open-responses-server middleware.
This engine may be replaced with OpenCode or Amazon Strands

- Node 22 (nvm install 22.15.1 | nvm use 22.15.1) required for Codex

The setup consists of three main components:
- Codex CLI: OpenAI's command-line interface for interacting with Codex.
- MCP Wrapper Server: A Node.js Express server that forwards MCP requests to Codex CLI and formats responses as MCP.
- open-responses-server: A middleware service that provides Responses API compatibility and MCP support.

# Clone this repository git clone https://github.com/yourusername/codex-mcp-wrapper.git cd codex-mcp-wrapper # Start the services ./start.sh

- Codex MCP wrapper on port 8080
- open-responses-server on port 3000

# Install dependencies npm install # Install Codex CLI globally npm install -g @openai/codex # Start the MCP server node mcp-server.js # Install the package in development mode pip install -e .

You can run the MCP server using either stdio or SSE transport:

# Using stdio (default) python -m mcp_server # Using SSE on a specific port python -m mcp_server --transport sse --port 8000

Clones a repository, checks out a specific branch (optional), navigates to a specific folder (optional), and runs Codex with the given request.

- repository(required): Git repository URL
- branch(optional): Git branch to checkout
- folder(optional): Folder within the repository to focus on
- request(required): Codex request/prompt to run

{ "repository": "https://github.com/username/repo.git", "branch": "main", "folder": "src", "request": "Analyze this code and suggest improvements" }

Clones a repository, reads the system prompt from.agent/system.md, parsesmodelIdfrom.agent/agent.json, writes the request to a.promptfile, and invokes the Codex CLI with the extracted model.

- repository(required): Git repository URL
- request(required): Prompt text to run through Codex
- folder(optional, default/): Subfolder within the repository to operate in

{ "repository": "https://github.com/username/repo.git", "folder": "src", "request": "Analyze this code and suggest improvements" }

Place amcps.jsonfile under the.agent/directory to register available MCP tools. Codex will load this configuration automatically.

{ "mcpServers": { "agentic-developer-mcp": { "url": "..." } } }

This project uses the MCP Python SDK to implement an MCP server. The primary implementation is inmcp_server/server.py.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Automatically generates documentation for code repositories by analyzing directory structures and code files using the OpenRouter API.

Provides fast C++ code intelligence for LLMs using the clangd language server.

Diagnoses token waste in Claude Code sessions with 6 anomaly types and severity scoring. Fully local.

A server for code modification and generation using Large Language Models.

Your AI Code Review Council - Get diverse perspectives from multiple AI models in parallel.

CLI token optimizer and AI context generator with built-in MCP server. Scans codebases to extract routes, schema, components, and dependencies 9x–13x token reduction for Claude Code, Cursor, Copilot, Codex, and Windsurf.

An MCP server for the codetoprompt library, enabling integration with LLM agents.

A coding assistant server that provides context-aware code suggestions, documentation integration, and technology detection.

Rewrites coding prompts for optimal results with AI IDEs like Cursor AI, powered by Claude by Anthropic.

Performs complementary code analysis by combining Claude Code and Google's Gemini AI.