Один мозг, много рук.

Сервер MCP, который обертывает OpenAI Codex SDK, позволяя запускать несколько специализированных агентов Codex — каждый со своей собственной моделью, песочницей, усилиями и индивидуальностью — от любого клиента MCP.

Почему

Кодекс очень мощный. Но один случай делает все одинаково. Иногда вам нужен строгий рецензент кода ** в песочнице только для чтения. ** тестовый автор ** с доступом к рабочему пространству. Дешевый помощник при минимальных усилиях. Глубокий мыслитель на xhigh.

Codex Octopus позволяет вам раскрутить столько, сколько вам нужно. То же двоичное, разные конфигурации. Каждый из них отображается как отдельный инструмент в вашем MCP-клиенте.

Предпосылки

Node.js >= 18 Codex CLI — Codex SDK порождает Codex CLI под капотом, поэтому его необходимо установить ([T0]) ** API-ключ OpenAI** ([T1]] env var) или унаследованный от родительского процесса

##Установка

Используйте [[Т2]] непосредственно в [[Т3]] (см. Быстрый запуск ниже).

Быстрый старт

Добавьте к своему [4]:

Это дает вам два инструмента: [Т5] и [Т6]. Вот и все — у вас есть Кодекс как инструмент.

Несколько агентов

Реальная мощность работает в нескольких экземплярах с различными конфигурациями:

Codex Octopus

One brain, many arms.

An MCP server that wraps the OpenAI Codex SDK, letting you run multiple specialized Codex agents — each with its own model, sandbox, effort, and personality — from any MCP client.

Why

Codex is powerful. But one instance does everything the same way. Sometimes you want a strict code reviewer in read-only sandbox. A test writer with workspace-write access. A cheap quick helper on minimal effort. A deep thinker on xhigh.

Codex Octopus lets you spin up as many of these as you need. Same binary, different configurations. Each one shows up as a separate tool in your MCP client.

Prerequisites

• Node.js >= 18
• Codex CLI — the Codex SDK spawns the Codex CLI under the hood, so you need it installed (@openai/codex)
• OpenAI API key (CODEX_API_KEY env var) or inherited from parent process

Install

npm install codex-octopus

Or use npx directly in your .mcp.json (see Quick Start below).

Quick Start

Add to your .mcp.json:

{
  "mcpServers": {
    "codex": {
      "command": "npx",
      "args": ["codex-octopus@latest"],
      "env": {
        "CODEX_SANDBOX_MODE": "workspace-write",
        "CODEX_APPROVAL_POLICY": "never"
      }
    }
  }
}

This gives you two tools: codex and codex_reply. That’s it — you have Codex as a tool.

Multiple Agents

The real power is running several instances with different configurations:

{
  "mcpServers": {
    "code-reviewer": {
      "command": "npx",
      "args": ["codex-octopus@latest"],
      "env": {
        "CODEX_TOOL_NAME": "code_reviewer",
        "CODEX_SERVER_NAME": "code-reviewer",
        "CODEX_DESCRIPTION": "Strict code reviewer. Read-only sandbox.",
        "CODEX_MODEL": "o3",
        "CODEX_SANDBOX_MODE": "read-only",
        "CODEX_APPEND_INSTRUCTIONS": "You are a strict code reviewer. Report real bugs, not style preferences.",
        "CODEX_EFFORT": "high"
      }
    },
    "test-writer": {
      "command": "npx",
      "args": ["codex-octopus@latest"],
      "env": {
        "CODEX_TOOL_NAME": "test_writer",
        "CODEX_SERVER_NAME": "test-writer",
        "CODEX_DESCRIPTION": "Writes thorough tests with edge case coverage.",
        "CODEX_MODEL": "gpt-5-codex",
        "CODEX_SANDBOX_MODE": "workspace-write",
        "CODEX_APPEND_INSTRUCTIONS": "Write tests first. Cover edge cases. TDD."
      }
    },
    "quick-qa": {
      "command": "npx",
      "args": ["codex-octopus@latest"],
      "env": {
        "CODEX_TOOL_NAME": "quick_qa",
        "CODEX_SERVER_NAME": "quick-qa",
        "CODEX_DESCRIPTION": "Fast answers to quick coding questions.",
        "CODEX_EFFORT": "minimal"
      }
    }
  }
}