Codex MCP Go MCP server

codex-mcp-go

Codex CLI 的 MCP 协议封装实现

⭐ 如果觉得好用，请给个 Star 吧！您的支持是我们更新的动力~ ⭐

English | 简体中文

简介

codex-mcp-go 是一个基于 Go 语言实现的 MCP (Model Context Protocol) 服务器。它封装了 OpenAI 的 Codex CLI，使其能够作为 MCP 工具被 KiloCode、Roo Code、Cline 等各种 "Vibe Coding" AI 客户端调用。

这个项目的初衷很简单：让强者更强，让专才专用。

在我自己的工作流中（在 KiloCode 里使用 Gemini 3.0 Pro），我发现像 Gemini 这样的先进模型拥有强大的规划能力和想象力，但在修复自己生成的复杂代码时偶尔会“卡壳”。而 Codex，这位老练的“代码老师傅”，虽然在宏大叙事上稍逊一筹，但在具体的代码实现、Bug 修复和遵循精确指令方面却无人能及。

所以，为什么不让它们合作呢？

受到 codexmcp (Python 实现) 的启发，我决定用我更喜欢的 Go 语言，边学 mcp-go-sdk 边重复造了这个轮子，主要目的是练手并打造一个更适合我自己的工具。

现在，你可以用一句话，在任何支持 MCP 的 Vibe Coding 工具中，让 Gemini 或 Claude 这样的“总指挥”去调用 Codex 这个“特种兵”来完成最棘手的编码任务。

主要特性：

• 会话管理：支持 SESSION_ID 维持多轮对话上下文。
• 沙箱控制：提供 read-only、workspace-write 等安全策略。
• 并发支持：基于 Go 协程，支持多客户端并发调用。
• 单文件部署：编译为单一二进制文件，无运行时依赖。

快速开始

1. 前置要求

本工具依赖 OpenAI 的 codex CLI。请确保您已安装并配置好它。

安装 Codex CLI:

# 使用 npm 安装 (推荐)
npm i -g @openai/codex

# 或者参考官方仓库
# https://github.com/openai/codex-cli

2. 安装 MCP Server

方式一：使用 npx (推荐)

无需安装 Go 环境，直接运行：

npx @zenfun510/codex-mcp-go

方式二：手动下载

从 Releases 页面下载对应平台的二进制文件。

方式三：源码构建

需要 Go 1.24+ 环境。

git clone https://github.com/w31r4/codex-mcp-go.git
cd codex-mcp-go
go build -o codex-mcp-go cmd/server/main.go

3. 配置 MCP 客户端

根据您使用的 AI 客户端，选择对应的配置方式。

方式 A：使用 npx (推荐)

Claude Code

claude mcp add codex -s user --transport stdio -- npx -y @zenfun510/codex-mcp-go

Roo Code (VSCode / Cursor)

在 Roo Code 的 MCP 设置中添加：

{
  "mcpServers": {
    "codex": {
      "command": "npx",
      "args": ["-y", "@zenfun510/codex-mcp-go"],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}

配置文件路径参考：

• VSCode: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/clinemcpsettings.json
• Cursor: ~/.config/Cursor/User/globalStorage/rooveterinaryinc.roo-cline/settings/clinemcpsettings.json

KiloCode

在 ~/.kilocode/mcp.json 中添加：

{
  "mcpServers": {
    "codex": {
      "command": "npx",
      "args": ["-y", "@zenfun510/codex-mcp-go"],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor (Native MCP)

1. 打开 Cursor 设置 -> Features -> MCP
2. 点击 "Add New MCP Server"
3. 填写配置：

• Name: codex
• Type: stdio
• Command: npx
• Args: -y @zenfun510/codex-mcp-go

方式 B：使用本地二进制文件

如果您已通过 go build 构建了二进制文件（假设路径为 /path/to/codex-mcp-go），可使用以下配置：

Claude Code

claude mcp add codex -s user --transport stdio -- /path/to/codex-mcp-go

Roo Code / KiloCode / 通用 JSON 配置

{
  "mcpServers": {
    "codex": {
      "command": "/path/to/codex-mcp-go",
      "args": [],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor (Native MCP)

1. 打开 Cursor 设置 -> Features -> MCP
2. 点击 "Add New MCP Server"
3. 填写配置：

• Name: codex
• Type: stdio
• Command: /path/to/codex-mcp-go
• Args: (留空)

4. 验证

Shortened. The full README is on GitHub.