Codex MCP Wrapper

Agentic Developer MCP

Este proyecto envuelve el CLI de Codex de OpenAI como un servidor MCP (Model Context Protocol), haciéndolo accesible a través del middleware TeaBranch/open-responses-server.
Este motor puede ser reemplazado con OpenCode o Amazon Strands

Requisitos

• Node 22 (nvm install 22.15.1 | nvm use 22.15.1) requerido para Codex

Descripción general

La configuración consta de tres componentes principales:

1. Codex CLI: La interfaz de línea de comandos de OpenAI para interactuar con Codex.
2. Servidor Wrapper MCP: Un servidor Node.js Express que reenvía solicitudes MCP al CLI de Codex y formatea las respuestas como MCP.
3. open-responses-server: Un servicio de middleware que proporciona compatibilidad con la API de Responses y soporte MCP.

Instalación

Usando Docker (Recomendado)

# Clone this repository
git clone https://github.com/yourusername/codex-mcp-wrapper.git
cd codex-mcp-wrapper

# Start the services
./start.sh

Esto iniciará:

• El wrapper MCP de Codex en el puerto 8080
• open-responses-server en el puerto 3000

Instalación manual

# 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 .

Uso

Puedes ejecutar el servidor MCP usando transporte stdio o SSE:

# Using stdio (default)
python -m mcp_server

# Using SSE on a specific port
python -m mcp_server --transport sse --port 8000

Documentación de herramientas

run_codex

Clona un repositorio, cambia a una rama específica (opcional), navega a una carpeta específica (opcional) y ejecuta Codex con la solicitud dada.

Parámetros

• repository (obligatorio): URL del repositorio Git
• branch (opcional): Rama de Git para cambiar
• folder (opcional): Carpeta dentro del repositorio en la que enfocarse
• request (obligatorio): Solicitud/prompt de Codex a ejecutar

Ejemplo

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

clone_and_write_prompt

Clona un repositorio, lee el prompt del sistema desde .agent/system.md, analiza modelId desde .agent/agent.json, escribe la solicitud en un archivo .prompt e invoca el CLI de Codex con el modelo extraído.

Parámetros

• repository (obligatorio): URL del repositorio Git
• request (obligatorio): Texto del prompt para ejecutar a través de Codex
• folder (opcional, por defecto /): Subcarpeta dentro del repositorio en la que operar

Ejemplo

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

Configuración de MCPS

Coloca un archivo mcps.json dentro del directorio .agent/ para registrar las herramientas MCP disponibles. Codex cargará esta configuración automáticamente.

Ejemplo de .agent/mcps.json:

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

Desarrollo

Este proyecto utiliza el SDK de Python de MCP para implementar un servidor MCP. La implementación principal está en mcp_server/server.py.

Licencia

MIT