Добавить сервер
aybelatchane/mcp-server-terminal
  1. Каталог MCP

aybelatchane/mcp-server-terminal

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

Terminal MCP Server

npm version npm downloads License: MIT

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

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 (переходит и активирует)

Параметры
  • 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)

1.0.5основная
1.0.3
1.0.2
1.0.1
1.0.0
0.0.1

Выберите клиент, чтобы установить aybelatchane/mcp-server-terminal:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "aybelatchane-mcp-server-terminal-gywyd7hgp2": {
      "args": [
        "mcp-server-terminal"
      ],
      "command": "npx"
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "aybelatchane-mcp-server-terminal-gywyd7hgp2": {
      "type": "stdio",
      "args": [
        "mcp-server-terminal"
      ],
      "command": "npx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"aybelatchane-mcp-server-terminal-gywyd7hgp2\",\"type\":\"stdio\",\"args\":[\"mcp-server-terminal\"],\"command\":\"npx\"}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "aybelatchane-mcp-server-terminal-gywyd7hgp2": {
      "args": [
        "mcp-server-terminal"
      ],
      "command": "npx"
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add aybelatchane-mcp-server-terminal-gywyd7hgp2 -- npx mcp-server-terminal

Либо через JSON-конфиг:

claude mcp add-json aybelatchane-mcp-server-terminal-gywyd7hgp2 "{\"args\":[\"mcp-server-terminal\"],\"command\":\"npx\"}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add aybelatchane-mcp-server-terminal-gywyd7hgp2 -- npx mcp-server-terminal

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

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

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите aybelatchane/mcp-server-terminal, а в поле команды запуска — строку ниже:
npx mcp-server-terminal

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "aybelatchane-mcp-server-terminal-gywyd7hgp2": {
      "args": [
        "mcp-server-terminal"
      ],
      "command": "npx",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например aybelatchane-mcp-server-terminal-gywyd7hgp2.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: aybelatchane-mcp-server-terminal-gywyd7hgp2
    command: npx
    args:
      - "mcp-server-terminal"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

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

wonderwhy-er/DesktopCommanderMCP

wonderwhy-er/DesktopCommanderMCP

от wonderwhy-er

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

JavaScript⭐ 10104
nvms/tui-mcp

nvms/tui-mcp

от nvms

MCP-сервер для управления TUI-приложениями через терминал. Поддерживает постоянные сессии: запускает TUI-программы (vim, htop), снимает скриншоты с xterm-эмуляцией, анализирует вывод.

JavaScript⭐ 14
ooples/mcp-console-automation

ooples/mcp-console-automation

от ooples

MCP сервер для автоматизации консольных приложений через AI: управляйте сессиями, мониторьте вывод и обнаруживайте ошибки. Поддерживает SSH, профили и фоновые задачи. Для разработчиков и DevOps.

TypeScript⭐ 52
ferrislucas/iterm-mcp

ferrislucas/iterm-mcp

от ferrislucas

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

TypeScript⭐ 570
laszlopere/mcp-tmux

laszlopere/mcp-tmux

от laszlopere

MCP-сервер для tmux: управляет сеансами, окнами, панелями, отправляет команды и читает вывод. Работает локально или по SSH. Подходит для парного программирования с ИИ — вы видите действия агента в реальном времени и можете перехватить управление. Полезен разработчикам.

Python⭐ 6
eirikb/any-cli-mcp-server

eirikb/any-cli-mcp-server

от eirikb

Превращает любую CLI-утилиту в MCP сервер. Анализируя вывод --help, автоматически создает MCP инструменты. Полезен разработчикам, автоматизирующим работу с консольными командами.

TypeScript⭐ 24
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин