Каталог MCP
aybelatchane
aybelatchane/mcp-server-terminal

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"]

terminal_click

Кликните по элементу интерфейса по его ref_id (перемещает и активирует)

Параметры

session_idstringобязательный
Session to interact with
ref_idstringобязательный
Element reference ID to click
inter_key_delay_msinteger
Delay between navigation keys in milliseconds

terminal_press_key

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

Параметры

session_idstringобязательный
Session to send key to
keystringобязательный
Key to press (e.g., "Enter", "Up", "Ctrl+c", "F1")

terminal_read_output

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

Параметры

session_idstringобязательный
Session to read from
max_bytesinteger
Maximum bytes to read (default: read all available)

terminal_session_close

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

Параметры

session_idstringобязательный
Session to close
forceboolean
Force close (send SIGKILL instead of SIGTERM)

terminal_session_create

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

Параметры

commandstringобязательный
Command to execute (e.g., "bash", "vim", "htop")
argsstring[]
Command arguments
dimensionsany
Terminal dimensions
cwdstring
Working directory
envobject
Environment variables
visualboolean
Enable visual mode (spawn visible terminal window) If not specified, defaults to server mode (visual unless --headless flag is set)
terminal_emulatorstring
Preferred terminal emulator (e.g., "gnome-terminal", "iTerm2", "auto") If not specified or "auto", will use the best available terminal for the platform

terminal_session_list

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

Параметры

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

terminal_session_resize

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

Параметры

session_idstringобязательный
Session to resize
dimensionsanyобязательный
New dimensions

terminal_snapshot

Сделайте запись текущего состояния терминала в виде структурированного Terminal State Tree с обнаруженными элементами интерфейса.

Параметры

session_idstringобязательный
Session to snapshot
include_raw_textboolean
Include raw text output
idle_threshold_msinteger
Idle threshold in milliseconds (wait for terminal to be idle)

terminal_type

Введите текст в терминальную сессию

Параметры

session_idstringобязательный
Session to type into
textstringобязательный
Text to type
delay_msinteger
Delay between characters in milliseconds

terminal_wait_for

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

Параметры

session_idstringобязательный
Session to wait on
textstring
Text to wait for (regex pattern)
element_typestring
Element type to wait for
goneboolean
Wait for text/element to disappear (gone)
idleboolean
Wait for terminal to be idle
timeout_msinteger
Timeout in milliseconds (default: 5000)
poll_interval_msinteger
Polling interval in milliseconds (default: 100)

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

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

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

Также aybelatchane/mcp-server-terminal можно установить в Cursor по ссылке автоматически.

FAQ

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

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

Что он умеет?

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

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

Номер в рейтинге: #184
Звезд на Github: 17
Форков на Github: 5
Язык реализации: Rust
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 17.07 в 01:48
Идентификатор: dTl2b3AX_qoyHrkK
Категории: Выполнение кода, Командная строка

Другие проверенные MCP-сервера

line/line-bot-mcp-server

официальный

MCP-сервер для интеграции AI-агентов с LINE Official Account через Messaging API. Отправляет текстовые и гибкие сообщения, управляет богатыми меню, получает профили пользователей и список подписчик...

vectorize-io/vectorize-mcp-server

официальный

MCP-сервер для интеграции с Vectorize: выполняет векторный поиск по документам, извлекает текст из любых файлов в Markdown и запускает Deep Research. Полезен разработчикам AI-приложений, работающих...

MarkItDown MCP

официальный

Инструмент для преобразования PDF, Word, Excel, изображений, аудио и других форматов в Markdown. Оптимален для подготовки данных для LLM-пайплайнов. Сохраняет структуру документов (заголовки, списки, таблицы).

anaisbetts/mcp-installer

MCP сервер, который автоматически устанавливает другие MCP серверы из npm и PyPi по запросу. Помогает разработчикам и пользователям Claude быстро добавлять нужные инструменты через простые команды. Требует npx и uv.

scrapegraphai/scrapegraph-ai

ScrapeGraphAI - MCP сервер для веб-скрапинга с LLM: опишите нужные данные, и он построит пайплайн извлечения. Полезен разработчикам и аналитикам для автоматизации сбора информации с сайтов и документов.

taylorwilsdon/google_workspace_mcp

Google Workspace MCP сервер для полного управления сервисами через естественный язык - Gmail, Drive, Calendar, Docs, Sheets и другие. Поддерживает OAuth 2.1 и многопользовательский режим. Идеален д...