Terminal MCP Server — MCP-сервер для Claude Code: терминал как UI
MCP-сервер, который даёт ИИ-агенту сессии терминала и структурированный снимок экрана: агент нажимает клавиши, кликает по элементам и ждёт нужный текст.
claude mcp add --env DISPLAY=<DISPLAY> --env RUST_LOG=<RUST_LOG> --transport stdio terminal-mcp-server -- npx -y mcp-server-terminalЧто делает Terminal MCP Server
Сервер поднимает терминальную сессию и отдаёт агенту её состояние в виде дерева. Дальше работа идёт инструментами: terminal_session_create открывает сессию, terminal_snapshot снимает экран вместе с найденными элементами интерфейса, terminal_press_key жмёт стрелки, F-клавиши и сочетания вроде Ctrl+X, terminal_click бьёт по элементу, terminal_wait_for ждёт текст или простой. Есть terminal_type, terminal_read_output, список и закрытие сессий, изменение размера.
По умолчанию сессия открывает видимое окно xterm. Для работы без экрана запускайте с --headless. Визуальный режим на Linux и в WSL требует X11, поэтому в конфиг добавляют переменную DISPLAY. На нативном Windows визуального режима нет — там доступен только headless, для полного набора функций авторы советуют WSL.
Логи включаются переменной RUST_LOG (error, warn, info, debug, trace). Поток stdout занят протоколом MCP, логи идут в stderr. Без DISPLAY в конфиге визуальная сессия на Linux не поднимется.
Какие задачи решает
- прогнать интерактивную программу вроде htop и снять состояние экрана
- нажать стрелку и дождаться, пока список перерисуется
- отправить команду в оболочку и прочитать её вывод
- кликнуть по пункту меню, найденному на экране
- держать несколько терминальных сессий и закрывать лишние
Примеры запросов агенту
- Создай терминальную сессию с htop и сделай снимок экрана
- Нажми стрелку вниз и подожди, пока таблица обновится
- Набери
ls -laи нажми Enter, потом покажи вывод
Как установить Terminal MCP Server
Командой платформы
claude mcp add --env DISPLAY=<DISPLAY> --env RUST_LOG=<RUST_LOG> --transport stdio terminal-mcp-server -- npx -y mcp-server-terminalВместо <…> подставьте свои значения
Командой платформы
codex mcp add terminal-mcp-server --env DISPLAY=<DISPLAY> --env RUST_LOG=<RUST_LOG> -- npx -y mcp-server-terminalВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"terminal-mcp-server": {
"command": "npx",
"args": [
"-y",
"mcp-server-terminal"
],
"env": {
"DISPLAY": "<DISPLAY>",
"RUST_LOG": "<RUST_LOG>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"terminal-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-server-terminal"
],
"env": {
"DISPLAY": "<DISPLAY>",
"RUST_LOG": "<RUST_LOG>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e DISPLAY=<DISPLAY> -e RUST_LOG=<RUST_LOG> terminal-mcp-server npx -y mcp-server-terminalВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Terminal MCP Server
Как установить Terminal MCP Server в Claude Code?
Одной командой: claude mcp add mcp-server-terminal -- npx -y mcp-server-terminal. Если нужны DISPLAY и RUST_LOG, используйте вариант с --env DISPLAY=<DISPLAY> --env RUST_LOG=<RUST_LOG> --transport stdio.
Что делает Terminal MCP Server?
Запускает терминальные сессии и даёт агенту снимок экрана с элементами интерфейса, ввод текста, нажатия клавиш, клики и ожидание нужного состояния.
Работает ли визуальный режим на Windows?
На нативном Windows только headless. Видимое окно xterm требует X11, и на Windows его получают через WSL.
