模型上下文协议服务器

一个用Rust实现的最小化模型上下文协议服务器,提供Codex GPT-5模型使用的update_plan和apply_patch工具,使开发者能在任何支持MCP的客户端中集成这些工具而无需运行Codex CLI。

  • by agynio
  • Rust
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 HautechAI/codex-tools-mcp

使用说明

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 在工作目录中。