Terminal MCP Server

Terminal MCP Server

aybelatchaneMIT
15 звёзд4 форков
Terminal MCP Server — это инструмент для AI-агентов, которые должны взаимодействовать с терминальными приложениями. Принцип работы напоминает Playwright: вместо того чтобы «смотреть» на экран, AI получает структурированное представление состояния терминала — Terminal State Tree. Благодаря этому агент видит содержимое экрана, понимает текущий контекст (например, какая команда выполняется или какие данные отображаются) и отправляет в терминал нажатия клавиш или команды. Сервер подходит разработчикам, DevOps-инженерам и администраторам, которые используют AI-ассистентов для автоматизации задач в командной строке. Он работает с любыми текстовыми интерфейсами — от простого bash до интерактивных утилит вроде vim, htop или nano. Сценарии использования включают автоматизацию рутины, тестирование терминальных утилит, обучение работе с командной строкой и быстрый доступ к системам мониторинга. Всё это через естественный язык — вы описываете задачу, AI выполняет её через сервер.

Установка

npx -y mcp-server-terminal

Характеристики

Общее

  • СтатусСообщество
  • Разработчикaybelatchane
  • ЛицензияMIT

Технологии

  • Языки
    Rust
  • Транспорт
    stdio

Описание

Возможности

  • Запуск команд и программ в терминале под управлением AI
  • Чтение и анализ вывода команд в реальном времени
  • Отправка отдельных нажатий клавиш и управление интерактивными приложениями
  • Получение структурированного слепка состояния терминала (Terminal State Tree) для понимания контекста
  • Автоматизация многошаговых сценариев в командной строке
  • Работа с любыми shell-средами: bash, zsh, sh и другими
  • Поддержка длительных процессов и сессий
  • Совместимость с десятками MCP-клиентов: Claude, Gemini, Codex, VS Code, Cursor, Windsurf, Zed и другими

Как подключить

Установите и запустите сервер одной командой:

npx mcp-server-terminal

Для постоянного использования добавьте конфигурацию в ваш MCP-клиент. Пример для Claude Desktop:

{ "mcpServers": { "terminal": { "command": "npx", "args": ["mcp-server-terminal"] } } }

После добавления перезапустите клиент. Сервер готов к работе.

Похожим образом конфигурация добавляется в VS Code, Cursor, Windsurf, Zed, Cline и другие редакторы.

Примеры запросов

  • «Покажи содержимое текущей директории»
  • «Найди все файлы, изменённые за последний час, и сгруппируй по размеру»
  • «Открой htop и определи процесс, который использует больше всего памяти»
  • «Войди в Python REPL, выполни расчёты и выйди»
  • «Обнови все npm-пакеты в проекте и покажи журнал изменений»

Технические детали

  • Язык реализации: Rust
  • Транспортный протокол: stdio (встроенный в MCP)
  • Лицензия: MIT (бесплатный для коммерческого и личного использования)
  • Совместимые клиенты: Claude (Code, Desktop), Gemini CLI, OpenAI Codex, VS Code / GitHub Copilot, Cursor, Windsurf, Zed, Cline (VS Code), AWS Bedrock
  • Для работы требуется Node.js (для npx) или предварительно собранный бинарник из GitHub Releases

Поделиться