Codex MCP Wrapper

Agentic Developer MCP

Este projeto encapsula o Codex CLI da OpenAI como um servidor MCP (Model Context Protocol), tornando-o acessível por meio do middleware TeaBranch/open-responses-server.
Este mecanismo pode ser substituído por OpenCode ou Amazon Strands

Requisitos

• Node 22 (nvm install 22.15.1 | nvm use 22.15.1) necessário para Codex

Visão Geral

A configuração consiste em três componentes principais:

1. Codex CLI: Interface de linha de comando da OpenAI para interagir com o Codex.
2. MCP Wrapper Server: Um servidor Node.js Express que encaminha solicitações MCP para o Codex CLI e formata as respostas como MCP.
3. open-responses-server: Um serviço de middleware que fornece compatibilidade com a Responses API e suporte a MCP.

Instalação

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

Isso iniciará:

• Codex MCP wrapper na porta 8080
• open-responses-server na porta 3000

Instalação 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

Você pode executar o servidor MCP usando transporte stdio ou SSE:

# Using stdio (default)
python -m mcp_server

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

Documentação das Ferramentas

run_codex

Clona um repositório, faz checkout de uma branch específica (opcional), navega para uma pasta específica (opcional) e executa o Codex com a solicitação fornecida.

Parâmetros

• repository (obrigatório): URL do repositório Git
• branch (opcional): Branch Git para checkout
• folder (opcional): Pasta dentro do repositório para focar
• request (obrigatório): Solicitação/prompt do Codex para executar

Exemplo

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

clone_and_write_prompt

Clona um repositório, lê o prompt do sistema de .agent/system.md, analisa modelId de .agent/agent.json, escreve a solicitação em um arquivo .prompt e invoca o Codex CLI com o modelo extraído.

Parâmetros

• repository (obrigatório): URL do repositório Git
• request (obrigatório): Texto do prompt para executar no Codex
• folder (opcional, padrão /): Subpasta dentro do repositório para operar

Exemplo

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

Configuração do MCPS

Coloque um arquivo mcps.json no diretório .agent/ para registrar as ferramentas MCP disponíveis. O Codex carregará essa configuração automaticamente.

Exemplo de .agent/mcps.json:

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

Desenvolvimento

Este projeto usa o SDK Python MCP para implementar um servidor MCP. A implementação principal está em mcp_server/server.py.

Licença

MIT