Каталог MCP

aybelatchane/mcp-server-terminal

MCP-сервер для управления терминальными приложениями AI-агентами через модель состояния. Поддерживает создание сессий, ввод текста, нажатие клавиш и снимки экрана. Полезен разработчикам для автомат...

README

10 инструментов

Версии

Установить сервер

Terminal MCP Server

MCP server enabling AI agents to interact with terminal applications through structured Terminal State Tree representation. Works with any AI assistant that supports the Model Context Protocol.

Installation

Via npm (Recommended)

npx mcp-server-terminal

Via GitHub Releases

Download pre-built binaries from Releases.

Build from Source

git clone https://github.com/aybelatchane/mcp-server-terminal.git
cd mcp-server-terminal
cargo build --release
# Binary: ./target/release/terminal-mcp

Configuration

Claude

Claude Code (CLI)

claude mcp add terminal -- npx mcp-server-terminal

Claude Desktop

Add to ~/.claude.json (macOS/Linux) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

OpenAI Codex

Codex CLI

codex mcp add terminal -- npx mcp-server-terminal

Codex Configuration File

Add to ~/.codex/config.toml:

[mcp_servers.terminal]
command = "npx"
args = ["mcp-server-terminal"]

Инструменты были проиндексированы: 05.09.2026

terminal_click

Нажимает на элемент интерфейса по его ref_id (переходит и активирует)

Параметры

inter_key_delay_msinteger
Задержка между клавишами навигации в миллисекундах
ref_idstringобязательный
Идентификатор ссылки элемента для нажатия
session_idstringобязательный
Сессия для взаимодействия

terminal_press_key

Нажмите специальную клавишу или комбинацию клавиш (стрелки, функциональные клавиши, Ctrl+X и т.д.)

Параметры

keystringобязательный
Клавиша для нажатия (например, "Enter", "Up", "Ctrl+c", "F1")
session_idstringобязательный
Сессия для отправки ключа

terminal_read_output

Читает сырой вывод из сессии терминала

Параметры

max_bytesinteger
Максимальное количество байт для чтения (по умолчанию: читать всё доступное)
session_idstringобязательный
Сессия, из которой читать

terminal_session_close

Закрыть и завершить сессию терминала

Параметры

forceboolean
Принудительно завершить (отправить SIGKILL вместо SIGTERM)
session_idstringобязательный
Закрыть сеанс

terminal_session_create

Создаёт новую сессию терминала с указанной командой

Параметры

argsstring[]
Аргументы команды
commandstringобязательный
Команда для выполнения (например, "bash", "vim", "htop")
cwdstring
Рабочая директория.
dimensionsany
Размеры терминала
envobject
Переменные среды
terminal_emulatorstring
Предпочтительный эмулятор терминала (например, "gnome-terminal", "iTerm2", "auto") Если не указано или указано "auto", будет использован лучший из доступных терминалов для данной платформы
visualboolean
Включает визуальный режим (запускает видимое окно терминала). Если не указано, по умолчанию используется серверный режим (визуальный, если не установлен флаг --headless).

terminal_session_list

Выведи список всех активных терминальных сессий

Параметры

Без параметров.

terminal_session_resize

Изменить размеры терминальной сессии

Параметры

dimensionsanyобязательный
Новые измерения
session_idstringобязательный
Сеанс для изменения размера.

terminal_snapshot

Захватывает текущее состояние терминала в виде структурированного Terminal State Tree с обнаруженными элементами UI.

Параметры

idle_threshold_msinteger
Порог простоя в миллисекундах (ожидание бездействия терминала)
include_raw_textboolean
Получает и запрашивает актуальную документацию и примеры кода из Context7 для любой программной библиотеки или фреймворка. Сначала необходимо вызвать инструмент 'Resolve Context7 Library ID', чтобы получить точный идентификатор библиотеки, совместимый с Context7 и необходимый для использования этого инструмента, ЗА ИСКЛЮЧЕНИЕМ случаев, когда пользователь явно указывает идентификатор библиотеки в формате '/org/project' или '/org/project/version' в своём запросе. Не вызывайте этот инструмент более 3 раз для одного вопроса.
session_idstringобязательный
Сеанс в снимок

terminal_type

Вводит текст в сеанс терминала

Параметры

delay_msinteger
Задержка между символами в миллисекундах.
session_idstringобязательный
Сеанс для ввода
textstringобязательный
Текст для ввода.

terminal_wait_for

Ожидать появления текста, отображения элемента или бездействия терминала.

Параметры

element_typestring
Тип элемента для ожидания.
goneboolean
Подожди, пока текст/элемент исчезнет (исчез).
idleboolean
Ожидает, пока терминал станет бездействующим.
poll_interval_msinteger
Интервал опроса в миллисекундах (по умолчанию: 100)
session_idstringобязательный
textstring
Текст для ожидания (регулярное выражение)
timeout_msinteger
Тайм-аут в миллисекундах (по умолчанию: 5000)

Github Сайт сервера

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Этот MCP-сервер даёт AI-агентам возможность полноценно работать с терминальными приложениями. Вместо того чтобы просто отдавать текст, он строит дерево состояния терминала — так AI понимает структуру интерфейса, может нажимать клавиши, кликать по элементам и читать вывод. Сервер пригодится для тестирования консольных утилит, автоматизации работы в htop, vim и любых других программах, работающих в терминале.

Что он умеет?

Этот MCP-сервер даёт AI-агенту прямой доступ к терминалу: запускает и закрывает сессии, меняет размер окна, печатает текст, нажимает клавиши и даже кликает по элементам интерфейса. Можно читать как сырой вывод, так и структурированное состояние терминала с распознанными UI-объектами. Есть команда ожидания — сервер подождёт, пока появится нужный текст, элемент или сессия перейдёт в простой.

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 19
Форков на Github: 5
Загрузок: 1 602
Язык реализации: Rust
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 07.09 в 02:33
Идентификатор: dTl2b3AX_qoyHrkK
Категории: Выполнение кода, Командная строка

Похожие MCP-сервера

ferrislucas/iterm-mcp

Разработчики: MCP сервер для iTerm дает модели полный контроль над терминалом - выполнение команд, чтение вывода, управление REPL. Эффективный расход токенов, простая интеграция. Делегируйте задачи и наблюдайте за работой.

alvii147/piston-mcp

Piston MCP Server - MCP-сервер для подключения LLM к Piston API для выполнения кода. Он даёт ИИ-ассистентам безопасно запускать скрипты на разных языках в песочнице. Полезен разработчикам ИИ-агенто...

Tommertom/awesome-ionic-mcp

MCP инструмент для разработчиков Ionic и Capacitor: предоставляет компоненты фреймворка, плагины, документацию и позволяет выполнять CLI команды прямо через AI-ассистента. Ускоряет создание кроссплатформенных приложений.

wonderwhy-er/DesktopCommanderMCP

Desktop Commander — MCP сервер для управления файлами, запуска терминальных команд, редактирования кода, работы с Excel, PDF и DOCX. Разработчики используют его для автоматизации задач и взаимодейс...

prisma/mcp

официальный

MCP сервер Prisma позволяет AI-агентам управлять базами данных Prisma Postgres: создавать бэкапы, выполнять SQL, интроспекцию схемы и миграции. Идеально для разработчиков, автоматизирующих работу с PostgreSQL через естественный язык.

tumf/mcp-shell-server

MCP сервер для безопасного удалённого выполнения команд оболочки с белым списком, изоляцией окружения и аудитом. Поддерживает stdin, пайпы и лимиты времени/вывода. Идеален для интеграции shell-команд в MCP с контролем безопасности.