Codex MCP Go

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

在 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/cline_mcp_settings.json
• Cursor: ~/.config/Cursor/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

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

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

1. 打開 Cursor 設置 -> Features -> MCP
2. 點擊 "Add New MCP Server"
3. 填寫配置：
   • Name: codex
   • Type: stdio
   • Command: npx
   • Args: -y @zenfun510/codex-mcp-go

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

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

1. 打開 Cursor 設置 -> Features -> MCP
2. 點擊 "Add New MCP Server"
3. 填寫配置：
   • Name: codex
   • Type: stdio
   • Command: /path/to/codex-mcp-go
   • Args: (留空)

## Core Instruction for CodeX MCP

在任何時刻，你必須思考當前過程可以如何與codex進行協作，如何調用Codex 為你提供的MCP工具作為你客觀全面分析的保障。
其中你**務必執行**以下幾個步驟：
**1** 在你對用戶需求形成初步分析後，將用戶需求、初始思路告知codex，並要求其完善需求分析和實施計劃。
**2** 在實施具體編碼任務前，**必須向codex索要代碼實現原型（要求codex僅給出unified diff patch，嚴禁對代碼做任何真實修改）**。在獲取代碼原型後，你**只能以此為邏輯參考，再次對代碼修改進行重寫**，形成企業生產級別、可讀性極高、可維護性極高的代碼後，才能實施具體編程修改任務。
**3** 無論何時，只要完成切實編碼行為後，**必須立即使用codex review代碼改動和對應需求完成程度**。
**4** codex只能給出參考，你**必須有自己的思考，甚至需要對codex的回答提出置疑**。盡信書則不如無書，你與codex的最終使命都是達成統一、全面、精準的意見，所以你們必須不斷爭辯已找到通向真理的唯一途徑。

## Codex Tool Invocation Specification

1. 工具概述
   codex MCP 提供了一個工具 `codex`，用於執行 AI 輔助的編碼任務。該工具**通過 MCP 協議調用**，無需使用命令行。

2. 工具參數
   **必選**參數：
   - PROMPT (string): 發送給 codex 的任務指令
   - cd (Path): codex 執行任務的工作目錄根路徑

   可選參數：
   - sandbox (string): 沙箱策略，可選值：
     - "read-only" (默認): 只讀模式，最安全
     - "workspace-write": 允許在工作區寫入
     - "danger-full-access": 完全訪問權限
   - SESSION_ID (UUID | null): 用於繼續之前的會話以與codex進行多輪交互，默認為 None（開啟新會話）
   - skip_git_repo_check (boolean): 是否允許在非 Git 倉庫中運行，默認 False
   - return_all_messages (boolean): 是否返回所有消息（包括推理、工具調用等），默認 False
   - image (List[Path] | null): 附加一個或多個圖片文件到初始提示詞，默認為 None
   - model (string | null): 指定使用的模型，默認為 None（使用用戶默認配置）
   - yolo (boolean | null): 無需審批運行所有命令（跳過沙箱），默認 False
   - profile (string | null): 從 `~/.codex/config.toml` 加載的配置文件名稱，默認為 None（使用用戶默認配置）

3. 調用規範
   **必須遵守**：
   - 每次調用 codex 工具時，必須保存返回的 SESSION_ID，以便後續繼續對話
   - cd 參數必須指向存在的目錄，否則工具會靜默失敗
   - 嚴禁codex對代碼進行實際修改，使用 sandbox="read-only" 以避免意外，並要求codex僅給出unified diff patch即可

   推薦用法：
   - 如需詳細追蹤 codex 的推理過程和工具調用，設置 return_all_messages=True
   - 對於精準定位、debug、代碼原型快速編寫等任務，優先使用 codex 工具

# Codex MCP Tool Rules

You have access to the `codex` tool, which wraps the OpenAI Codex CLI. Use it for complex code generation, debugging, and analysis.

## Workflow
1.  **Consultation**: Before writing complex code, ask Codex for a plan or analysis.
2.  **Prototyping**: Ask Codex for a `unified diff patch` to solve the problem.
    *   **IMPORTANT**: Always use `sandbox="read-only"` when asking for code.
    *   **IMPORTANT**: Do NOT let Codex apply changes directly.
3.  **Implementation**: Read the Codex-generated diff, understand it, and then apply the changes yourself using your own file editing tools.
4.  **Review**: After applying changes, you can ask Codex to review the code.

## Tool Usage
-   **Session**: Always capture and reuse `SESSION_ID` for multi-turn tasks.
-   **Path**: Ensure `cd` is set to the current workspace root.
-   **Safety**: Default to `sandbox="read-only"`. Only use `workspace-write` if explicitly instructed by the user and you are confident in the operation.