@missdeer/codex-mcp-rs

NPM package for codex-mcp-rs - A high-performance Rust implementation of MCP (Model Context Protocol) server that wraps the Codex CLI.

Quick Start

Run directly with npx - no installation required:

npx @missdeer/codex-mcp-rs

This automatically downloads the correct binary for your platform and launches the MCP server.

Installation

Option 1: Use via npx (Recommended)

npx @missdeer/codex-mcp-rs

npx handles everything automatically:

1. Checks for the latest version
2. Downloads the pre-built binary for your OS/architecture
3. Launches the MCP server on stdio transport

Add to Claude Code:

claude mcp add codex-rs -s user --transport stdio -- npx @missdeer/codex-mcp-rs

Option 2: Global Installation

npm install -g @missdeer/codex-mcp-rs

This downloads and caches the binary locally for faster startup on subsequent runs.

Usage with Claude Code

After installation, add to your Claude Code MCP configuration:

claude mcp add codex-rs -s user --transport stdio -- codex-mcp-rs

Or manually add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "codex-rs": {
      "command": "codex-mcp-rs",
      "transport": "stdio"
    }
  }
}

Features

• ✨ High-performance Rust implementation
• 🚀 Low memory footprint
• 🔒 Configurable sandbox policies
• 🔄 Session management for multi-turn conversations
• 🖼️ Image attachment support
• ⚡ Fast async I/O with Tokio

Supported Platforms

• Linux (x86_64, arm64)
• macOS (x86_64, arm64)
• Windows (x86_64, arm64)

Prerequisites

You must have the Codex CLI installed and configured on your system.

Tool Parameters

The server provides a codex tool with the following parameters:

• PROMPT (required): Task instruction
• cd (required): Working directory
• sandbox: Security policy (read-only, workspace-write, danger-full-access)
• SESSION_ID: Resume previous session
• skip_git_repo_check: Allow running outside git repos
• return_all_messages: Return full reasoning trace
• image: Attach image files
• model: Override Codex model
• yolo: Disable all prompts
• profile: Load config profile

Documentation

For detailed documentation, see the GitHub repository.

License

MIT License - Copyright (c) 2025 missdeer

Related Projects

• codexmcp - Python implementation
• codex-mcp-go - Go implementation
• geminimcp - Gemini CLI MCP server