Каталог MCP
x51xxx
x51xxx/codex-mcp-tool

x51xxx/codex-mcp-tool

MCP инструмент для интеграции Codex CLI с Claude и Cursor. Позволяет анализировать файлы через @-ссылки, вести многошаговые сессии в изолированном окружении и применять структурированные правки. Полезен разработчикам для безопасного рефакторинга.

README

13 инструментов

Установить сервер

Codex MCP Server

MCP server connecting Claude/Cursor to Codex CLI. Enables code analysis via @ file references, multi-turn conversations, sandboxed edits, and structured change mode.

Features

File Analysis — Reference files with @src/, @package.json syntax
Multi-Turn Sessions — Conversation continuity with workspace isolation
Native Resume — Uses codex resume for context preservation (CLI v0.36.0+)
Local OSS Models — Run with Ollama or LM Studio via localProvider
Web Search — Research capabilities with search: true
Sandbox Mode — Safe code execution with --full-auto
Change Mode — Structured OLD/NEW patch output for refactoring
Brainstorming — SCAMPER, design-thinking, lateral thinking frameworks
Health Diagnostics — CLI version, features, and session monitoring
Cross-Platform — Windows, macOS, Linux fully supported

Quick Start

claude mcp add codex-cli -- npx -y @trishchuk/codex-mcp-tool

Prerequisites: Node.js 18+, Codex CLI installed and authenticated.

Configuration

{
  "mcpServers": {
    "codex-cli": {
      "command": "npx",
      "args": ["-y", "@trishchuk/codex-mcp-tool"]
    }
  }
}

ask-codexвнешний мир

Запускает Codex CLI с анализом файлов (@syntax), навыками ($syntax), выбором модели и контролем безопасности. Поддерживает changeMode.

Параметры

promptstringобязательный
Task or question. Use @ to include files (e.g., '@largefile.ts explain').
modelstring
Optional model override. Known: gpt-5.6, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.4-mini. If omitted, uses your Codex CLI default (~/.codex/config.toml). Specify only to override.
sandboxboolean
Quick automation mode: enables workspace-write with approval=never. Sandboxing remains active.
fullAutoboolean
Compatibility alias for workspace-write with approval=never (not --yolo)
approvalPolicyenum
Approval: never, on-request, untrusted
neveron-requestuntrusted
approvalenum
Approval policy: untrusted, on-request, never
neveron-requestuntrusted
sandboxModeenum
Access: read-only, workspace-write, danger-full-access
read-onlyworkspace-writedanger-full-access
yoloboolean
⚠️ Bypass all safety (dangerous)
cdstring
Working directory
workingDirstring
Working directory for execution
changeModeboolean
Return structured OLD/NEW edits for refactoring
chunkIndexnumber
Chunk index (1-based)
chunkCacheKeystring
Cache key for continuation
imageany
Optional image file path(s) to include with the prompt
configany
Configuration overrides as 'key=value' string or object
profilestring
Configuration profile to use from ~/.codex/config.toml
timeoutnumber
Maximum execution time in milliseconds (optional)
includeThinkingboolean
Include reasoning/thinking section in response
includeMetadataboolean
Include configuration metadata in response
searchboolean
Enable web search using native --search flag (v0.52.0+). Requires network access - automatically sets sandbox to workspace-write if not specified.
ossboolean
Use local Ollama server (convenience for -c model_provider=oss). Requires Ollama running locally. Automatically sets sandbox to workspace-write if not specified.
localProviderenum
Specify which local provider to use (lmstudio or ollama). Automatically enables --oss if not set. If omitted with --oss, uses config default or shows selection.
lmstudioollama
enableFeaturesstring[]
Enable feature flags (repeatable). Equivalent to -c features.<name>=true
disableFeaturesstring[]
Disable feature flags (repeatable). Equivalent to -c features.<name>=false
addDirsstring[]
Additional writable directories beyond workspace (e.g., ["/tmp", "/var/log"]). Useful for monorepos and multi-directory projects.
toolOutputTokenLimitnumber
Maximum tokens for tool outputs (100-10,000). Controls response verbosity.
reasoningEffortenum
Reasoning depth. Omit to use the CLI default. max/ultra are model-dependent GPT-5.6 options; ultra may delegate to subagents.
lowmediumhighxhighmaxultra
sessionIdstring
Session ID for conversation continuity. Enables native Codex resume.
resetSessionboolean
Clear session context before execution. Starts fresh conversation.
outputSchemaany
JSON Schema path or inline schema to constrain output format (Codex CLI v0.95.0+)
personalityenum
Communication style: pragmatic (concise, machine-friendly) or friendly (conversational). Codex CLI v0.94.0+
pragmaticfriendly
skipGitRepoCheckboolean
Skip git repository validation. Useful for non-git directories (Codex CLI v0.75.0+)
outputLastMessagestring
Write final Codex message to file path. Useful for CI/CD result capture (Codex CLI v0.95.0+)
strictConfigboolean
Fail when config.toml contains fields unknown to the installed Codex CLI
ephemeralboolean
Run without persisting Codex session files to disk
ignoreUserConfigboolean
Ignore $CODEX_HOME/config.toml for this run; authentication is still loaded
ignoreRulesboolean
Ignore user and project execpolicy .rules files for this run
bypassHookTrustboolean
DANGEROUS: run enabled hooks without persisted hook trust
responseModeenum
Response verbosity: "clean" returns only the final answer (default), "full" returns the complete execution log including thinking, tool calls, and agent activity
cleanfull

batch-codexвнешний мир

Делегирует множественные атомарные задачи Codex для пакетной обработки. Идеально подходит для повторяющихся операций, массового рефакторинга и автоматизированных преобразований кода.

Параметры

tasksobject[]обязательный
Array of atomic tasks to delegate to Codex
modelstring
Optional model override applied to every task. Known: gpt-5.6, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.4-mini. If omitted, uses your Codex CLI default (~/.codex/config.toml).
sandboxstring
Sandbox mode: read-only, workspace-write, danger-full-access
parallelboolean
Execute independent tasks in parallel
concurrencyinteger
Maximum parallel Codex processes when parallel=true. Default: min(task count, 4)
stopOnErrorboolean
Stop execution if any task fails
timeoutnumber
Maximum execution time per task in milliseconds
workingDirstring
Working directory for execution
searchboolean
Enable live web search for all tasks using the native --search flag
ossboolean
Use local Ollama server
enableFeaturesstring[]
Enable feature flags
disableFeaturesstring[]
Disable feature flags

brainstormвнешний мир

Генерируйте креативные идеи с помощью структурированных фреймворков с учётом контекста предметной области и анализа осуществимости.

Параметры

promptstringобязательный
Brainstorming challenge or question
modelstring
Optional model override. Known: gpt-5.6, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.4-mini. If omitted, uses your Codex CLI default (~/.codex/config.toml).
approvalPolicyenum
Approval: never, on-request, untrusted
neveron-requestuntrusted
sandboxModeenum
Access: read-only, workspace-write, danger-full-access
read-onlyworkspace-writedanger-full-access
fullAutoboolean
Compatibility alias for workspace-write with approval=never
yoloboolean
⚠️ Bypass all safety (dangerous)
cdstring
Working directory
methodologyenum
Framework: divergent, convergent, scamper, design-thinking, lateral, auto (default)
divergentconvergentscamperdesign-thinkinglateralauto
domainstring
Domain: software, business, creative, research, product, marketing, etc.
constraintsstring
Limitations: budget, time, technical, legal, etc.
existingContextstring
Background info or previous attempts
ideaCountinteger
Number of ideas (default: 12, range: 5-30)
includeAnalysisboolean
Include feasibility/impact analysis
searchboolean
Enable live web search using the native --search flag
ossboolean
Use local Ollama server
localProviderenum
Specify which local provider to use (lmstudio or ollama). Automatically enables --oss if not set.
lmstudioollama
enableFeaturesstring[]
Enable feature flags
disableFeaturesstring[]
Disable feature flags
reasoningEffortenum
Reasoning depth. Default: high (creative ideation benefits from depth). Override with "xhigh" for very complex domains, "medium" for quick exploration.
lowmediumhighxhighmaxultra
personalityenum
Communication style: pragmatic (concise, machine-friendly) or friendly (conversational). Codex CLI v0.94.0+
pragmaticfriendly

do-actвнешний мир

Выполни задачу через Codex, проверь shell-командой, при ошибке — автоматически исправь. Цикл Act-Check-Fix.

Параметры

taskstringобязательный
Task for Codex to execute
verifyobject
Shell command to validate result. Triggers act-check-fix loop on failure.
maxRetriesinteger
Max retry attempts if verify fails. Default: 2
modelstring
Optional model override. Known: gpt-5.6, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.4-mini. If omitted, uses your Codex CLI default (~/.codex/config.toml).
fullAutoboolean
Compatibility alias for workspace-write with approval=never
sandboxModeenum
Access: read-only, workspace-write, danger-full-access
read-onlyworkspace-writedanger-full-access
workingDirstring
Working directory
timeoutnumber
Codex timeout per attempt in ms. Default: 10min
reasoningEffortenum
Reasoning depth. Default: high (act-check-fix loops benefit from depth so retries converge). Override with "xhigh" for hard tasks, "medium" for simple verifiable steps.
lowmediumhighxhighmaxultra
ossboolean
Use local Ollama/LM Studio
localProviderenum
lmstudioollama

fetch-chunkтолько чтениеидемпотентный

Извлекает кэшированные чанки из ответа changeMode. Используйте это для получения последующих чанков после получения частичного ответа changeMode.

Параметры

cacheKeystringобязательный
The cache key provided in the initial changeMode response
chunkIndexnumberобязательный
Which chunk to retrieve (1-based index)

healthтолько чтениеидемпотентныйвнешний мир

Проверьте состояние Codex CLI и сессии.

Параметры

sessionIdstring
Optional session ID to check specific session health
verboseboolean
Include detailed diagnostic information

helpтолько чтениеидемпотентный

Получить справочную информацию

Параметры

Без параметров.

list-sessions

Выводит список всех активных сессий диалогов с метаданными, а также управляет сессиями.

Параметры

actionenum
Action: list (default), delete (single session), clear (all sessions)
listdeleteclear
sessionIdstring
Session ID for delete action

list-skillsтолько чтениеидемпотентный

Обнаружить доступные скиллы Codex из директории .agents/skills/

Параметры

workingDirstring
Working directory to search for skills. Defaults to resolved working directory.

pingтолько чтениеидемпотентный

Echo

Параметры

promptstring
Message to echo

review-changesтолько чтениеидемпотентныйвнешний мир

Выполнить код-ревью текущего репозитория с помощью встроенной команды ревью Codex CLI.

Параметры

promptstring
Custom review instructions or focus areas (cannot be used with uncommitted=true; use base/commit review instead)
uncommittedboolean
Review staged, unstaged, and untracked changes (working tree) - cannot be combined with custom prompt
basestring
Review changes against a specific base branch (e.g., "main", "develop")
commitstring
Review the changes introduced by a specific commit SHA
titlestring
Optional title to display in the review summary
modelstring
Optional model override. Known: gpt-5.6, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna, gpt-5.5, gpt-5.4, gpt-5.4-mini. If omitted, uses your Codex CLI default (~/.codex/config.toml).
reasoningEffortenum
Reasoning depth for the review. Default: high (code review benefits from deep reasoning).
lowmediumhighxhighmaxultra
workingDirstring
Working directory to run the review in (passed via -C as a global Codex option)
timeoutnumber
Maximum execution time in milliseconds

timeout-testтолько чтениеидемпотентный

Проверьте защиту от тайм-аута, запустив выполнение на заданное время.

Параметры

durationnumberобязательный
Duration in milliseconds (minimum 10ms)

versionтолько чтениеидемпотентныйвнешний мир

Показывает версию и информацию о системе

Параметры

Без параметров.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@trishchuk/codex-mcp-tool"
  ]
}

Также x51xxx/codex-mcp-tool можно установить в Cursor по ссылке автоматически.

FAQ

Для чего этот сервер?

Сервер соединяет Claude или Cursor с Codex CLI, чтобы разработчики могли анализировать код через @-ссылки, вести многошаговые диалоги с сохранением контекста, безопасно редактировать файлы в песочнице и получать структурированные патчи для рефакторинга. Это позволяет работать с кодом напрямую из чата, не переключаясь между инструментами, и подключать локальные open-source модели.

Что он умеет?

Анализирует файлы по @ссылкам, запускает задачи через Codex CLI, делает массовый рефакторинг и код-ревью, применяет структурированные правки через changeMode. Управляет сессиями — просматривает, удаляет, очищает. Генерирует идеи по креативным фреймворкам вроде SCAMPER. Проверяет версию и здоровье CLI. Работает с локальными OSS-моделями, песочницей, веб-поиском и выполняет act-check-fix-циклы.

Информация о сервере

Номер в рейтинге: #183
Звезд на Github: 23
Форков на Github: 6
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 19.07 в 08:28
Идентификатор: qa7vEHKDzd41uGmG
Категории: Агенты, Агенты для программирования, Анализ кода, Выполнение кода, ИИ и машинное обучение, Инструменты для разработчиков

Другие проверенные MCP-сервера

txn2/kubefwd

kubefwd — bulk порт-форвардинг для Kubernetes: сервисы из кластера становятся доступны локально по именам. Каждый сервис получает уникальный loopback IP, исключая конфликты портов. Авто-переподключ...

zilliztech/mcp-server-milvus

официальный

MCP-сервер для векторной базы Milvus. Предоставляет LLM-приложениям векторный и гибридный поиск, управление коллекциями, операции с данными. Полезен разработчикам, интегрирующим AI с Claude Desktop...

anaisbetts/mcp-installer

MCP сервер, который автоматически устанавливает другие MCP серверы из npm и PyPi по запросу. Помогает разработчикам и пользователям Claude быстро добавлять нужные инструменты через простые команды. Требует npx и uv.

buildkite/buildkite-mcp-server

официальный

MCP-сервер для интеграции данных Buildkite (пайплайны, сборки, задания, тесты) с AI-инструментами и редакторами. Разработчики могут анализировать CI/CD-процессы через ИИ-ассистентов.

apinetwork/piapi-mcp-server

официальный

MCP-сервер для генерации медиаконтента через PiAPI: изображения, видео, музыка и 3D-модели. Поддерживает Midjourney, Flux, Kling и другие модели. Полезен разработчикам и креаторам, использующим Cla...

translated/lara-mcp

официальный

MCP сервер для профессионального перевода через Lara Translate. Переводит текст с учётом контекста, глоссариев и памяти переводов, определяет язык. Полезен разработчикам и переводчикам для точных д...