Name | codex-as-mcp JSON |
Version |
0.1.15
JSON |
| download |
home_page | None |
Summary | MCP server that provides access to codex CLI for code generation and review |
upload_time | 2025-08-08 11:17:46 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.11 |
license | None |
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"
}