AI辅助编码服务器

法典委员会

中文文档

MCP（模型上下文协议）服务器的高性能Rust实现，它封装了用于AI辅助编码任务的Codex CLI。

特性

• MCP协议支持：使用Rust SDK实现官方的模型上下文协议
• 食品法典整合：包装Codex CLI，通过MCP实现人工智能辅助编码
• 会话管理：支持通过会话ID进行多回合对话
• 沙箱安全：可配置的沙盒策略（只读、工作区写入、危险完全访问）
• 智能标准模式：当管道包含特殊字符或超过长度限制时，通过stdin自动发出管道提示 force_stdin 以（权力）否决
• 图像支持：将图像附加到视觉上下文提示中
• 异步运行时：基于Tokio构建，实现高效异步I/O
• 交叉平台的：Linux、macOS和Windows的预构建二进制文件（x64和arm64）

支持的平台

先决条件

• 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

发生了什么：

1. npm安装特定于平台的二进制包(@codex-mcp-rs/darwin-universal, @codex-mcp-rs/linux-x64等等）
2. 在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.toml
• timeout_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 go -Go实现
• 双子座 -Gemini CLI的Python MCP服务器

贡献

欢迎投稿！看 贡献.md 作为指导方针。

许可证

该项目具有双重许可：

非商业/个人使用-GNU通用公共许可证v3.0

免费用于个人项目、教育目的、开源项目和非商业用途。看 许可证 获取完整的GPLv3许可证文本。

商业/工作场所使用-需要商业许可证

如果您在商业环境、工作场所或出于任何商业目的使用codex mcp-rs，您必须获得商业许可证。

这包括但不限于：

• 在工作中使用该软件（任何组织）
• 融入商业产品或服务
• 用于客户工作或咨询
• 作为SaaS/云服务的一部分提供

联系: missdeer@gmail.com用于商业许可查询。

看 许可电子商务 了解更多详情。

星迹