acodex MCP
Локальный мост в запущенное приложение Codex для macOS: скрипты и агенты вызывают его инструменты через CLI или MCP-сервер.
- 59 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Перезапуск открывает порт отладки, через который локальный процесс управляет приложением Codex и его потоками.
Установка
- Работает в
Ручная установка
uv tool install acodexНужны macOS, приложение Codex и `uv`; затем `acodex config init` и `acodex codex relaunch --yes`.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Перезапуск открывает порт отладки, через который локальный процесс управляет приложением Codex и его потоками.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
acodex соединяет скрипты и агентов с запущенным настольным приложением Codex. Он перезапускает Codex с портом отладки Chrome DevTools Protocol, поднимает управляемый HTTP/MCP-сервер и вызывает живые инструменты `codex_app.*`, которые есть в вашей сборке приложения. Писать обвязку для CDP самому не нужно. В CLI есть проверка настроек, перезапуск Codex, запуск и остановка сервера, а также просмотр и вызов инструментов: `acodex tools list` показывает доступные, `acodex tools call codex_app.list_threads --limit 1` вызывает один. MCP-совместимый сервер отдает те же инструменты по адресу `/mcp` для локальных клиентов автоматизации.
Для кого. Тем, кто автоматизирует настольный Codex на macOS: пишет скрипты над потоками и сессиями или подключает его к другому агенту.
Подходит, если
- Скрипту нужен список потоков Codex и запуск действий без ручных кликов.
- Другой агент должен управлять приложением Codex через MCP.
- Надо проверить, какие инструменты `codex_app.*` есть в текущей сборке.
- Нужна диагностика связи с приложением через `acodex doctor --deep`.
Не подходит, если
- Работа идет в Windows или Linux: сценарий перезапуска рассчитан на macOS.
- Приложения Codex нет: мост управляет только им.
- Отладочный порт в приложении недопустим по политике безопасности.
Пример запроса к агенту
Запусти acodex, выведи список инструментов приложения Codex и покажи последний поток.MCP
- Транспорт
- http
- Авторизация
- не нужна
Переменные окружения
ACODEX_CODEX_APP_PATH- Путь к приложению Codex, если оно лежит не в `/Applications/Codex.app`.
Ограничения
Нужны macOS с установленным `/Applications/Codex.app` (другой путь задает `ACODEX_CODEX_APP_PATH`), Python 3.10 или новее и `uv`. Перезапуск приложения открывает порт CDP на `http://127.0.0.1:45217`, через который доступны живые инструменты. Набор инструментов зависит от сборки Codex и может меняться. Сервер слушает локально, но любой процесс на этой машине, дотянувшийся до порта, получает управление приложением.
Как отключить. Остановите сервер командой `acodex server stop`, перезапустите Codex обычным способом без порта отладки и удалите пакет через `uv tool uninstall acodex`.
Частые вопросы
Как поставить acodex?
Выполните `uv tool install acodex`, затем `acodex config init`, `acodex codex relaunch --yes` и `acodex server start`. Нужны macOS и приложение Codex.
Зачем перезапускать Codex?
Приложение запускают с портом отладки CDP: по умолчанию `http://127.0.0.1:45217`. Через него acodex видит и вызывает живые инструменты.
Как вызвать инструмент из терминала?
Выполните `acodex tools list`, затем `acodex tools call codex_app.list_threads --limit 1`. Простые аргументы передаются флагами, вложенные в виде JSON.
Как остановить мост?
Командой `acodex server stop`. Состояние сервера показывает `acodex server status`, журнал `acodex server logs --tail 50`.
Где лежит конфигурация?
Путь печатает `acodex config path`, а содержимое показывает `acodex config show`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыOpen Computer Use
open-computer-use
Открытый MCP-сервер для управления рабочим столом: агент читает состояние приложений и кликает, печатает, скроллит на macOS, Linux и Windows
MCP-сервер дает агенту видеть экран и управлять macOS, Windows и Linux: скриншоты, клики, ввод, OCR и память экрана
DesktopCtl — локальный CLI для macOS: агент смотрит на экран через OCR, кликает и печатает, облако и зрение у модели не нужны
Управление рабочим столом macOS, Windows и Android, Chrome и Electron через MCP: скриншоты, OCR, клики и ввод текста
MCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса
Плагин Codex ускоряет Computer Use: короткие связки кликов и ввода в браузере и приложениях macOS с проверкой итога.
Коротко о README
Быстрый старт, команды CLI и раздел поддержки. Инструмент подается как локальная автоматизация без самостоятельной работы с CDP.