RO

raychao-oao/pty-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

20 stars 2 forks Качество 59 Тренд 24MIT

MCP-сервер для интерактивных терминальных сессий — локальные оболочки, SSH, последовательные порты и постоянные удаленные сессии

Обзор

Сервер MCP (Model Context Protocol), который предоставляет агентам ИИ интерактивные терминальные сессии — локальные оболочки, SSH, последовательные порты и постоянные удаленные сеансы, которые выживают, отключаются. Создан для тех, кто хочет, чтобы ИИ помогал с реальным управлением серверами и устройствами, а не только с генерацией кода. Агенты ИИ запускают команды в неинтерактивных оболочках. Они не могут: - SSH в сервер и взаимодействовать с запущенными процессами - Подключаться к маршрутизаторам или коммутаторам через последовательную консоль - Мониторинг журналов и реагировать, когда происходит конкретное событие - Сохранить состояние сеанса по нескольким командам - Ждать перезагрузки сервера и обнаруживать, когда он резервируется pty-mcp решает все эти проблемы, предоставляя реальные сессии PTY по MCP. Без pty-mcp агенты искусственного интеллекта прибегают к циклам 30 & & check status — сжиганию циклов процессора и вызовов API в ожидании того, что произойдет. С wait for агент блокирует серверную сторону до тех пор, пока не произойдет событие. Меньше опросов, меньше энергии, лучше для белых медведей.

Обзор (машинный перевод)

Сервер MCP (Model Context Protocol), который предоставляет агентам ИИ интерактивные терминальные сессии — локальные оболочки, SSH, последовательные порты и постоянные удаленные сеансы, которые выживают, отключаются.

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

Почему

Агенты ИИ запускают команды в неинтерактивных оболочках. Они не могут: SSH в сервер и взаимодействует с запущенными процессами Подключение к маршрутизаторам или коммутаторам через последовательную консоль Мониторинг журналов и реакция, когда происходит конкретное событие Сохраняйте состояние сеанса в нескольких командах Подождите, пока сервер перезагрузится, и узнайте, когда он резервируется

pty-mcp решает все эти проблемы, предоставляя реальные сессии PTY по MCP.

Без pty-mcp агенты ИИ прибегают к петлям sleep 30 && check_status — сжиганию циклов процессора и вызовам API в ожидании того, что произойдет. С wait_for агент блокирует серверную сторону до тех пор, пока не произойдет событие. Меньше опросов, меньше энергии, лучше для белых медведей. ️

##Использовать кейсы

** Административное обслуживание**

** Управление сетевыми устройствами**

Мониторинг и оповещение

** Долгосрочные задачи, которые выживают отключены**

Особенности

Описание / Description

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

pty-mcp

An MCP (Model Context Protocol) server that gives AI agents interactive terminal sessions — local shells, SSH, serial ports, and persistent remote sessions that survive disconnects.

Built for sysadmins and network engineers who want AI to help with real server and device management, not just code generation.

Why

AI agents run commands in non-interactive shells. They can’t:

  • SSH into a server and interact with running processes
  • Connect to routers or switches via serial console
  • Monitor logs and react when a specific event occurs
  • Keep session state across multiple commands
  • Wait for a server to reboot and detect when it’s back up

pty-mcp solves all of these by providing real PTY sessions over MCP.

Without pty-mcp, AI agents resort to sleep 30 && check_status loops — burning CPU cycles and API calls waiting for things to happen. With wait_for, the agent blocks server-side until the event occurs. Less polling, less energy, better for polar bears. 🐻‍❄️

Use Cases

Server administration

# Reboot a server and wait until it's back online
create_local_session("ping myserver")
read_output(wait_for: "bytes from", timeout: 300)
→ blocks until server responds after reboot (~80s, one tool call)

Network device management

# Connect to a router via serial console
create_serial_session(port: "/dev/ttyUSB0", baud: 9600)
send_input("show interfaces status")
read_output(wait_for: "\\$")

Log monitoring and alerting

# Watch logs and act when something happens
create_ssh_session(host: "prod", user: "admin")
send_input("tail -f /var/log/app.log")
read_output(wait_for: "ERROR|CRITICAL", timeout: 3600)
→ returns the error line + context when it appears

Long-running tasks that survive disconnects

create_ssh_session(host: "server", user: "admin", persistent: true)
send_input("apt upgrade -y")
detach_session()          → close Claude Code, task continues
# Reconnect later to check result

Features

Feature Description
Local terminal Interactive bash/python/node sessions on local machine
SSH sessions Connect to remote hosts with key/password auth, SSH config support
Serial port Connect to devices via serial (IoT, embedded, network gear)
Persistent sessions Sessions survive SSH disconnects via ai-tmux daemon
Attach/Detach Detach from a running session, reconnect later
Control keys Send ctrl+c, ctrl+d, arrow keys, tab, escape
Settle detection Waits for output to settle before returning (smart timeout)
Pattern matching wait_for blocks until a regex pattern appears in output (v0.2.0)
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →