codex-as-mcp


Namecodex-as-mcp JSON
Version 0.1.15 PyPI version JSON
download
home_pageNone
SummaryMCP server that provides access to codex CLI for code generation and review
upload_time2025-08-08 11:17:46
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseNone
keywords ai code-generation codex mcp
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # codex-as-mcp

[δΈ­ζ–‡η‰ˆ](./README.cn.md)

Enable Claude Code, Cursor and other AI tools to call Codex for task execution. Plus/Pro/Team subscribers can maximize GPT-5 usage without additional costs.

## Execution Modes

πŸ”’ **Safe Mode (Default)**: Read-only operations, no file modifications
⚑ **Writable Mode**: Full codex capabilities with file/git operations

### Why Sequential Execution?
Codex is an agent that modifies files and system state. Running multiple instances in parallel could cause file conflicts, git race conditions, and conflicting system modifications. Sequential execution prevents these issues.

## Setup

### 1. Install Codex CLI
```bash
npm install -g @openai/codex
codex login
```

### 2. Configure MCP

Add to your `.mcp.json`:
**Safe Mode (Default):**
```json
{
  "mcpServers": {
    "codex": {
      "type": "stdio",
      "command": "uvx",
      "args": ["codex-as-mcp@latest"],
      "env": {}
    }
  }
}
```

**Writable Mode:**
```json
{
  "mcpServers": {
    "codex": {
      "type": "stdio",
      "command": "uvx",
      "args": ["codex-as-mcp@latest", "--yolo"],
      "env": {}
    }
  }
}
```

Or use Claude Code commands:
```bash
# Safe mode (default)
claude mcp add codex-as-mcp -- uvx codex-as-mcp@latest

# Writable mode  
claude mcp add codex-as-mcp -- uvx codex-as-mcp@latest --yolo

# Show detailed mode explanation
uvx codex-as-mcp@latest --help-modes
```

### 3. Usage

The MCP server exposes two tools:
- `codex_execute(prompt, work_dir)` - General purpose codex execution
- `codex_review(review_type, work_dir, target?, prompt?)` - Specialized code review

## Safety

- **Safe Mode**: Default read-only operations protect your environment
- **Writable Mode**: Use `--yolo` flag when you need full codex capabilities
- **Sequential Execution**: Prevents conflicts from parallel agent operations
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "codex-as-mcp",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "ai, code-generation, codex, mcp",
    "author": null,
    "author_email": "kky <kky42@example.com>",
    "download_url": "https://files.pythonhosted.org/packages/73/b7/a9141223b42b6d2e124e3c6b11518c37d2e030cec5b2a42079c41a9505d3/codex_as_mcp-0.1.15.tar.gz",
    "platform": null,
    "description": "# codex-as-mcp\n\n[\u4e2d\u6587\u7248](./README.cn.md)\n\nEnable Claude Code, Cursor and other AI tools to call Codex for task execution. Plus/Pro/Team subscribers can maximize GPT-5 usage without additional costs.\n\n## Execution Modes\n\n\ud83d\udd12 **Safe Mode (Default)**: Read-only operations, no file modifications\n\u26a1 **Writable Mode**: Full codex capabilities with file/git operations\n\n### Why Sequential Execution?\nCodex is an agent that modifies files and system state. Running multiple instances in parallel could cause file conflicts, git race conditions, and conflicting system modifications. Sequential execution prevents these issues.\n\n## Setup\n\n### 1. Install Codex CLI\n```bash\nnpm install -g @openai/codex\ncodex login\n```\n\n### 2. Configure MCP\n\nAdd to your `.mcp.json`:\n**Safe Mode (Default):**\n```json\n{\n  \"mcpServers\": {\n    \"codex\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"codex-as-mcp@latest\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\n**Writable Mode:**\n```json\n{\n  \"mcpServers\": {\n    \"codex\": {\n      \"type\": \"stdio\",\n      \"command\": \"uvx\",\n      \"args\": [\"codex-as-mcp@latest\", \"--yolo\"],\n      \"env\": {}\n    }\n  }\n}\n```\n\nOr use Claude Code commands:\n```bash\n# Safe mode (default)\nclaude mcp add codex-as-mcp -- uvx codex-as-mcp@latest\n\n# Writable mode  \nclaude mcp add codex-as-mcp -- uvx codex-as-mcp@latest --yolo\n\n# Show detailed mode explanation\nuvx codex-as-mcp@latest --help-modes\n```\n\n### 3. Usage\n\nThe MCP server exposes two tools:\n- `codex_execute(prompt, work_dir)` - General purpose codex execution\n- `codex_review(review_type, work_dir, target?, prompt?)` - Specialized code review\n\n## Safety\n\n- **Safe Mode**: Default read-only operations protect your environment\n- **Writable Mode**: Use `--yolo` flag when you need full codex capabilities\n- **Sequential Execution**: Prevents conflicts from parallel agent operations",
    "bugtrack_url": null,
    "license": null,
    "summary": "MCP server that provides access to codex CLI for code generation and review",
    "version": "0.1.15",
    "project_urls": {
        "Homepage": "https://github.com/kky42/codex-as-mcp",
        "Issues": "https://github.com/kky42/codex-as-mcp/issues",
        "Repository": "https://github.com/kky42/codex-as-mcp"
    },
    "split_keywords": [
        "ai",
        " code-generation",
        " codex",
        " mcp"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "da2381e67c3c8e3d78fdc33e41da99523fee33ebaabb0cdf18cdd4ab92a84d7a",
                "md5": "775db6473f8fbe2246179a7687c80109",
                "sha256": "545a57008a57341edebace8ec918beebe14d8115b6fd52e46daca1a65a19f9db"
            },
            "downloads": -1,
            "filename": "codex_as_mcp-0.1.15-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "775db6473f8fbe2246179a7687c80109",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 6624,
            "upload_time": "2025-08-08T11:17:44",
            "upload_time_iso_8601": "2025-08-08T11:17:44.465579Z",
            "url": "https://files.pythonhosted.org/packages/da/23/81e67c3c8e3d78fdc33e41da99523fee33ebaabb0cdf18cdd4ab92a84d7a/codex_as_mcp-0.1.15-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "73b7a9141223b42b6d2e124e3c6b11518c37d2e030cec5b2a42079c41a9505d3",
                "md5": "7ad062fedfc144696620452aaa66c8be",
                "sha256": "2753db3ac3fedb943bc4fafb0e8db563985a34607fe7938013b0c442860db060"
            },
            "downloads": -1,
            "filename": "codex_as_mcp-0.1.15.tar.gz",
            "has_sig": false,
            "md5_digest": "7ad062fedfc144696620452aaa66c8be",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 49907,
            "upload_time": "2025-08-08T11:17:46",
            "upload_time_iso_8601": "2025-08-08T11:17:46.069699Z",
            "url": "https://files.pythonhosted.org/packages/73/b7/a9141223b42b6d2e124e3c6b11518c37d2e030cec5b2a42079c41a9505d3/codex_as_mcp-0.1.15.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-08 11:17:46",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "kky42",
    "github_project": "codex-as-mcp",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "codex-as-mcp"
}
        
Elapsed time: 1.62891s