法典委员会
  ](https://www.rust-lang.org) 
MCP（模型上下文协议）服务器的高性能Rust实现，它封装了用于AI辅助编码任务的Codex CLI。
特性
- MCP协议支持：使用Rust SDK实现官方的模型上下文协议
- 食品法典整合：包装Codex CLI，通过MCP实现人工智能辅助编码
- 会话管理：支持通过会话ID进行多回合对话
- 沙箱安全：可配置的沙盒策略（只读、工作区写入、危险完全访问）
- 智能标准模式：当管道包含特殊字符或超过长度限制时，通过stdin自动发出管道提示
force_stdin以（权力）否决 - 图像支持：将图像附加到视觉上下文提示中
- 异步运行时：基于Tokio构建，实现高效异步I/O
- 交叉平台的：Linux、macOS和Windows的预构建二进制文件（x64和arm64）
支持的平台
| 平台 | 架构 | 二进制 |
|---|---|---|
| Linux | x86_64 | codex-mcp-rs_Linux_x86_64.tar.gz |
| Linux | arm64 | codex-mcp-rs_Linux_arm64.tar.gz |
| macOS | 通用（x64+arm64） | codex-mcp-rs_Darwin_universal.tar.gz |
| Windows | x86_64 | codex-mcp-rs_Windows_x86_64.zip |
| Windows | arm64 | codex-mcp-rs_Windows_arm64.zip |
先决条件
- Rust 1.77.2+（Windows命令行参数转义修复所必需）
- Codex CLI 已安装并配置
- Claude Code或其他MCP客户端
建筑
# Debug build
cargo build
# Release build
cargo build --release跑步
服务器通过stdio传输进行通信：
cargo run或者在建造之后：
./target/release/codex-mcp-rs快速开始
最快的入门方法是使用npx：
npx @missdeer/codex-mcp-rs此命令会自动为您的平台（Windows/MOSC/Linux，x64/arm64）安装正确的预构建二进制文件，并启动MCP服务器。无需手动安装。
将其添加到克劳德代码中：
claude mcp add codex-rs -s user --transport stdio -- npx @missdeer/codex-mcp-rs安装
选项1：通过npx使用（推荐）
使用npx是最简单的方法-它自动处理二进制安装：
npx @missdeer/codex-mcp-rs发生了什么：
- npm安装特定于平台的二进制包(
@codex-mcp-rs/darwin-universal,@codex-mcp-rs/linux-x64等等） - 在stdio传输上启动MCP服务器
添加到克劳德代码MCP配置：
claude mcp add codex-rs -s user --transport stdio -- npx @missdeer/codex-mcp-rs或者全局安装以加快启动速度：
npm install -g @missdeer/codex-mcp-rs
claude mcp add codex-rs -s user --transport stdio -- codex-mcp-rs全局安装在本地缓存二进制文件，以便立即启动。
选项2：通过安装脚本安装（Linux/macOS）
自动下载并安装最新版本的二进制文件 /opt/codex-mcp-rs/:
curl -sSL https://raw.githubusercontent.com/missdeer/codex-mcp-rs/master/scripts/install.sh | bash此脚本将：
- 检测您的平台和架构
- 从GitHub下载最新版本
- 将二进制文件安装到
/opt/codex-mcp-rs/codex-mcp-rs - 自动将其添加到您的Claude Code MCP配置中
选项3：从版本安装
从以下网址下载适用于您平台的二进制文件 发布页面，提取它，并添加到您的MCP配置中：
claude mcp add codex-rs -s user --transport stdio -- /path/to/codex-mcp-rs选项4：从源代码构建
git clone https://github.com/missdeer/codex-mcp-rs.git
cd codex-mcp-rs
cargo build --release
claude mcp add codex-rs -s user --transport stdio -- $(pwd)/target/release/codex-mcp-rs工具使用
服务器提供单一 codex 工具具有以下参数：
必填参数
PROMPT（string）：Codex任务说明cd（string）：工作目录路径
可选参数
sandbox（string）：沙盒策略-"read-only"（默认），"workspace-write"，或"danger-full-access"SESSION_ID（string）：继续上一个会话进行多回合对话skip_git_repo_check（bool）：允许在git存储库之外运行（默认值：false)return_all_messages（bool）：返回完整的推理跟踪（默认值：false)image（数组）：要附加的图像文件的路径model（string）：覆盖Codex模型yolo（bool）：禁用所有提示和沙盒profile（string）：从加载配置文件~/.codex/config.tomltimeout_secs（数字）：代码执行超时（秒）（默认值：600，最大值：3600）force_stdin（bool）：强制通过stdin而不是CLI参数传递提示符（默认值：false).启用后，无论内容如何，提示始终通过stdin管道传输。当提示超过800个字符或包含shell特殊字符时，也会自动触发。
测试
该项目具有全面的测试覆盖范围：
# Run all tests
cargo test
# Run with coverage
cargo tarpaulin --out Html
# See detailed testing guide
cat TESTING.md测试类别：
- 单元测试 （10） ：核心功能（escape_prompt、选项）
- 集成测试 （10） ：端到端场景
- 服务器测试 （5） ：MCP协议实施
- CI测试：多平台验证
总计：25项测试通过✅
当前测试覆盖率：请参阅 Codecov
建筑
看 CLAUDE.md 获取详细的架构文档。
与其他实施方式的比较
| 特性 | codex mcp-rs（Rust） | codexmcp（Python） | codex mcp-go |
|---|---|---|---|
| 语言 | Rust | Python | Go |
| 演出⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | |
| 内存使用情况 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ |
| 二进制大小 | 中等 | N/A | 小 |
| 启动时间 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| 会话管理 | ✓ | ✓ | ✓ |
| 图像支持 | ✓ | ✓ | ✓ |
| 沙盒策略 | ✓ | ✓ | ✓ |
相关项目
- codex mcp go -Go实现
- 双子座 -Gemini CLI的Python MCP服务器
贡献
欢迎投稿！看 贡献.md 作为指导方针。
许可证
该项目具有双重许可：
非商业/个人使用-GNU通用公共许可证v3.0
免费用于个人项目、教育目的、开源项目和非商业用途。看 许可证 获取完整的GPLv3许可证文本。
商业/工作场所使用-需要商业许可证
如果您在商业环境、工作场所或出于任何商业目的使用codex mcp-rs，您必须获得商业许可证。
这包括但不限于：
- 在工作中使用该软件（任何组织）
- 融入商业产品或服务
- 用于客户工作或咨询
- 作为SaaS/云服务的一部分提供
联系: missdeer@gmail.com用于商业许可查询。
看 许可电子商务 了解更多详情。
星迹
