My Codex MCP

codex-mcp

MCP server wrapping the Codex CLI for code reviews and queries.

Prerequisites

Install the Codex CLI:

npm install -g @openai/codex

Installation

Option 1: Clone and build

git clone git@github.com:jnew00/my-codex-mcp.git
cd my-codex-mcp
npm install
npm run build

Then add to your Claude Code config (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "codex": {
      "command": "node",
      "args": ["/path/to/my-codex-mcp/dist/index.js"]
    }
  }
}

Option 2: npx (after publishing to npm)

{
  "mcpServers": {
    "codex": {
      "command": "npx",
      "args": ["codex-mcp"]
    }
  }
}

Tool

codex

Send a prompt to Codex CLI.

Parameters:

Example:

{
  "prompt": "Review this code for security issues",
  "code": "function login(user) { db.query(`SELECT * FROM users WHERE name='${user}'`); }",
  "context": "Node.js backend, security-critical"
}

Development

npm test                  # Unit tests
npm run test:integration  # Integration tests (calls Codex CLI)
npm run build             # Build TypeScript