使用说明
Codex Tools MCP 服务器
一个最小的 模型上下文协议 用Rust实现的服务器,该服务器提供了 update_plan 和 apply_patch Codex GPT-5模型所使用的工具。它允许开发人员在任何MCP(多客户端协议)感知客户端中集成这些工具,而无需运行Codex CLI(命令行界面)。
构建并运行
前提条件: 在构建之前,请安装 Rust 工具链 1.90.0 或更高版本(支持 2024 版本)。例如:。 rustup toolchain install 1.90.0 并且 rustup override set 1.90.0 在这个目录中。
cargo build --release
该二进制文件通过标准输入输出(stdio)使用JSON-RPC 2.0协议进行通信。请从一个兼容MCP的主机(例如,MCP Inspector或任何能够启动基于stdio的服务器的工具运行器)上启动它。运行 ./target/release/codex-tools-mcp --help 用于命令行选项(日志级别、版本信息)。
工具模式(或工具架构)
update_plan符合在(某处)定义的模式codex-rs/core/src/plan_tool.rs(必需的plan带有数组的step和status,可选explanation)。apply_patch与在(某处)定义的JSON变体相匹配codex-rs/core/src/tool_apply_patch.rs(必填input包含完整补丁有效载荷的字符串。
这个(或“该”) apply_patch 该工具重用了官方的Codex codex-apply-patch 创建用于解析和应用补丁的工具,因此文件更改的处理方式与命令行界面(CLI)中完全一致。服务器在MCP(管理控制协议)响应中流式传输与CLI等效的摘要信息。 update_plan 返回确认信息“计划已更新”。
代理SDK演示
为了在本地进行测试而不暴露HTTP端点,可以使用OpenAI Agents SDK配合stdio MCP服务器:
pip install openai-agents
OPENAI_API_KEY=your_key python3 scripts/agents_demo.py
设置 OPENAI_API_KEY (或者事先导出它)以便Agents SDK能够与OpenAI进行身份验证。这会通过标准输入输出(stdio)运行codex MCP二进制文件,并要求它写入 hello world! 进入 hello.txt 在工作目录中。