os-control-mcp

MCP-локальный сервер для постоянных сессий терминала. Процесс поддерживает Bash, CMD, PowerShell, pwsh или WSL активными и разделяет отправку ввода от инкрементального чтения вывода.

Также имеет постоянные цели: агент может создать цель с критериями приёмки, выполнить несколько шагов, проверить доказательства и продолжать до завершения, сбоя, блокировки или достижения заданных лимитов.

Внимание: этот сервер управляет процессами с правами пользователя, который его запускает. Используйте его локально, не запускайте от имени администратора/root по умолчанию и никогда не открывайте процесс напрямую в интернет.

Транспорт

Сервер использует MCP JSONL через stdio. По умолчанию не открывает сетевой порт.

Related MCP server: Persistent Terminal MCP Server

Оболочки

• bash, sh, zsh в системах POSIX;

• cmd, powershell и pwsh в Windows;

• wsl-bash в Windows, используя дистрибутив, заданный в OS_CONTROL_WSL_DISTRO или kali-linux по умолчанию.

Интерактивный поток

1. os_create_session создаёт постоянную сессию.

2. os_send_input немедленно записывает в PTY/ConPTY.

3. os_read_output использует since_seq для получения только нового вывода.

4. os_session_status отслеживает PID, оболочку, каталог и завершение.

Вне цели autonomous потенциально разрушительные команды требуют явного подтверждения. В автономной цели авторизация непрерывна в пределах шагов и времени, заданных целью. Сервер предназначен для локального использования и должен оставаться защищённым аутентификацией и областью действия при размещении за удалённым туннелем.

Автономные цели

Рекомендуемый поток:

1. os_create_session создаёт постоянный терминал.

2. os_goal_start принимает цель, критерии и session_id.

3. os_send_input использует goal_id для выполнения без повторного подтверждения.

4. os_read_output читает инкрементальный вывод.

5. os_goal_update записывает действие, результат, доказательство и следующий шаг.

6. Агент повторяет, пока не подтвердит все критерии.

Сервер не придумывает следующее действие и не вызывает модель сам; он поддерживает состояние и лимиты цели. Клиент/агент должен продолжать вызовы до терминального состояния.

Установка

git clone https://github.com/Willian-2-0-0-1/os-control-mcp.git
cd os-control-mcp
python -m pip install -r requirements.txt

В Windows pywinpty включает ConPTY для CMD и PowerShell. В Kali/Linux бэкенд использует нативный PTY. Файл .mcp.json может использоваться MCP-клиентами, которые принимают локальные серверы через stdio.

Плагин для GPT/Codex

Репозиторий содержит манифест .codex-plugin/plugin.json и MCP-сервер. Это позволяет распространять пакет для клиентов, совместимых с MCP-плагинами.

Для использования в ChatGPT с локальным сервером каждый пользователь должен запускать свой собственный экземпляр и настроить приватное соединение. Репозиторий GitHub сам по себе не даёт ChatGPT доступ к компьютеру пользователя.