https://github.com/rolling-codes/codex-mcp
Multi-agent code-execution pipeline (plan → code → test → heal) as a Claude Code MCP plugin. Runs inside your existing Claude Code session — no separate API key, no second bill, no external loop.
https://github.com/rolling-codes/codex-mcp
Last synced: 24 days ago
JSON representation
Multi-agent code-execution pipeline (plan → code → test → heal) as a Claude Code MCP plugin. Runs inside your existing Claude Code session — no separate API key, no second bill, no external loop.
- Host: GitHub
- URL: https://github.com/rolling-codes/codex-mcp
- Owner: rolling-codes
- Created: 2026-04-26T04:39:59.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-26T05:36:34.000Z (2 months ago)
- Last Synced: 2026-04-26T06:25:17.337Z (2 months ago)
- Language: TypeScript
- Size: 47.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# codex-mcp
A local service for automated code execution and validation.
## Quick start
```bash
# 1. install
npm install
# 2. configure
cp .env.example .env
# edit .env — set ANTHROPIC_API_KEY
# 3. build + auto-register with Claude Code
npm run setup
```
`npm run setup` builds the project and writes the MCP server config into both:
- `/.claude/mcp.json` (project-scoped)
- `~/.claude/mcp.json` (global)
Restart Claude Code to activate.
## Environment
| Var | Required | Default | Description |
|-----|----------|---------|-------------|
| `ANTHROPIC_API_KEY` | yes | — | Anthropic API key |
| `GHOST_MODE` | no | `false` | Suppress internal refs in output |
## Tool: `run_codex_task`
**Input:**
```json
{ "task": "string", "context": "string (optional)" }
```
**Output (only if validation passes):**
```json
{ "result": "string", "tests": "string", "summary": "string" }
```
Output is blocked if automated validation fails. Invalid inputs are rejected at the boundary.
## Manual MCP config (if needed)
```json
{
"mcpServers": {
"codex-mcp": {
"command": "node",
"args": ["/absolute/path/to/dist/index.js"],
"env": {
"ANTHROPIC_API_KEY": "...",
"GHOST_MODE": "false"
}
}
}
}
```