codex-mcp-bridge

Небольшой политический слой между ChatGPT и официальным локальным MCP-сервером Codex.

ChatGPT
  -> OpenAI Secure MCP Tunnel
  -> codex-mcp-bridge (loopback HTTP)
  -> codex mcp-server (stdio)
  -> one explicitly allowed repository

Официальный MCP-сервер Codex уже предоставляет codex и codex-reply. Этот мост намеренно добавляет только элементы управления, необходимые для более безопасного ежедневного использования из ChatGPT:

• bridge_status: проверка активной политики.

• codex_read: принудительный сеанс Codex только для чтения.

• codex_run: запуск сеанса чтения или записи с ограничениями политики.

• codex_reply: продолжение только того потока, который был создан через этот мост.

• codex_job_status: получение результата длительной операции.

Безопасность по умолчанию

• Привязка к 127.0.0.1.

• Разрешается одна текущая рабочая директория, если явно не настроены корневые каталоги.

• Используется песочница Codex read-only.

• Используется политика одобрения on-request.

• Никогда не предоставляется danger-full-access.

• Блокируется запись в рабочую область, если владелец моста не запустит профиль записи.

• Отклоняются пути за пределами настроенных корневых каталогов реальных путей.

• Отклоняются репозитории, содержащие распространённые имена секретных файлов, если владелец явно не отключит предварительную проверку.

• Ограничивается размер подсказки и количество одновременных заданий Codex.

• Подавляется stderr вышестоящего Codex, если не включено локальное отладочное логирование.

Эти средства управления являются политическим слоем, а не изоляцией на уровне ОС. Используйте промежуточную копию, контейнер, виртуальную машину или отдельного пользователя ОС, когда требуется жёсткая изоляция.

Related MCP server: mcp-governance-proxy

Требования

• Node.js 20 или новее; рекомендуется Node.js 22.

• Установленный, аутентифицированный Codex CLI, предоставляющий codex mcp-server.

• tunnel-client и безопасный MCP-туннель OpenAI для доступа к ChatGPT.

Официальные ссылки:

• Запуск Codex в качестве MCP-сервера

• Безопасный MCP-туннель

Установка

npm ci
npm run check

Локальный смоук-тест

Локальный режим никогда не создаёт публичную конечную точку:

npm run bridge:local -- --root /absolute/path/to/repository

Конечная точка MCP: http://127.0.0.1:8876/mcp, конечная точка проверки работоспособности: http://127.0.0.1:8876/healthz.

Безопасный MCP-туннель

Создайте туннель в OpenAI Platform, затем укажите его учётные данные времени выполнения вне этого репозитория:

export CONTROL_PLANE_API_KEY="<runtime-key>"
export CONTROL_PLANE_TUNNEL_ID="tunnel_..."

npm run bridge:secure -- --root /absolute/path/to/repository

Запускающий скрипт собирает мост, запускает его на loopback, инициализирует профиль туннеля, выполняет tunnel-client doctor и поддерживает работу туннельного клиента.

Для намеренной сессии записи:

npm run bridge:secure -- --root /absolute/path/to/repository --write

Не оставляйте профиль записи запущенным, когда он не нужен.

Связка ключей macOS

security add-generic-password -a "$USER" -s "codex-mcp-bridge:control-plane-api-key" -w "<runtime-key>" -U
security add-generic-password -a "$USER" -s "codex-mcp-bridge:control-plane-tunnel-id" -w "tunnel_..." -U

CODEX_MCP_BRIDGE_ROOT=/absolute/path/to/repository npm run bridge:secure:keychain

Используйте bridge:secure:write:keychain только для намеренной сессии записи.

Конфигурация

Старый префикс переменных CODEX_GPT_BRIDGE_* временно принимается для совместимости с вышестоящим проектом.

Настройка ChatGPT

См. docs/chatgpt-setup.md.

Вышестоящий проект

Этот репозиторий является производным от DeepCogNeural/codex-gpt-bridge под лицензией MIT. См. UPSTREAM.md для описания области этого форка.