terminal-mcp — MCP-сервер для Claude Code: что делает, установка
Даёт агенту постоянные терминальные сессии для SSH, REPL, CLI баз данных и TUI-приложений. Пригодится для команд с состоянием между вызовами.
claude mcp add --env TERMINAL_MCP_MAX_SESSIONS=<TERMINAL_MCP_MAX_SESSIONS> --env TERMINAL_MCP_IDLE_TIMEOUT=<TERMINAL_MCP_IDLE_TIMEOUT> --transport stdio terminal-mcp -- uvx terminal-mcpЧто делает terminal-mcp
terminal-mcp запускает постоянные PTY-сессии, которые сохраняются между вызовами инструментов. Агент может отправлять команды, читать вывод, нажимать специальные клавиши и работать с интерактивными программами. Сервер предоставляет инструменты session_create, session_interact, session_read, session_send, session_wait_for, session_exec и session_close.
С ним можно подключаться по SSH, открывать Python REPL, выполнять запросы через psql, управлять TUI-приложениями и ждать завершения долгой сборки по шаблону. Режим diff возвращает только изменившиеся строки экрана, а опасные команды требуют подтверждения. Для запуска через uvx нужен Python 3.10+.
Какие задачи решает
- поддерживать SSH-сессию между командами
- выполнять код в интерактивном Python REPL
- оставлять подключение к CLI базы данных
- управлять TUI-приложением с клавиатуры
- ждать завершения долгой сборки по шаблону
Примеры запросов агенту
- Подключись к серверу по SSH, создай сессию с меткой
prodи выполниdf -h, затем покажи результатdocker ps. - Открой Python REPL в постоянной сессии, загрузи
data.csvчерез pandas и выведи описание таблицы. - Запусти
npm run buildв отдельной сессии и жди шаблонBuild complete|ERRORдо завершения.
Как установить terminal-mcp
Командой платформы
claude mcp add --env TERMINAL_MCP_MAX_SESSIONS=<TERMINAL_MCP_MAX_SESSIONS> --env TERMINAL_MCP_IDLE_TIMEOUT=<TERMINAL_MCP_IDLE_TIMEOUT> --transport stdio terminal-mcp -- uvx terminal-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminal-mcp <команда>
Командой платформы
codex mcp add terminal-mcp --env TERMINAL_MCP_MAX_SESSIONS=<TERMINAL_MCP_MAX_SESSIONS> --env TERMINAL_MCP_IDLE_TIMEOUT=<TERMINAL_MCP_IDLE_TIMEOUT> -- uvx terminal-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminal-mcp <команда>
Файл настроек
{
"mcpServers": {
"terminal-mcp": {
"command": "uvx",
"args": [
"terminal-mcp"
],
"env": {
"TERMINAL_MCP_MAX_SESSIONS": "<TERMINAL_MCP_MAX_SESSIONS>",
"TERMINAL_MCP_IDLE_TIMEOUT": "<TERMINAL_MCP_IDLE_TIMEOUT>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminal-mcp <команда>
Файл настроек
{
"servers": {
"terminal-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"terminal-mcp"
],
"env": {
"TERMINAL_MCP_MAX_SESSIONS": "<TERMINAL_MCP_MAX_SESSIONS>",
"TERMINAL_MCP_IDLE_TIMEOUT": "<TERMINAL_MCP_IDLE_TIMEOUT>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminal-mcp <команда>
Командой платформы
gemini mcp add -e TERMINAL_MCP_MAX_SESSIONS=<TERMINAL_MCP_MAX_SESSIONS> -e TERMINAL_MCP_IDLE_TIMEOUT=<TERMINAL_MCP_IDLE_TIMEOUT> terminal-mcp uvx terminal-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from terminal-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о terminal-mcp
Как установить terminal-mcp в Claude Code?
Выполните claude mcp add terminal-mcp -- uvx terminal-mcp.
Что делает terminal-mcp?
Сервер даёт агенту постоянные терминальные сессии. Через них можно работать с SSH, REPL, CLI баз данных, TUI-приложениями и долгими процессами.
Какие настройки сессий поддерживает terminal-mcp?
Лимит сессий и время простоя задаются переменными TERMINAL_MCP_MAX_SESSIONS и TERMINAL_MCP_IDLE_TIMEOUT.
