SSH-Exec MCP

Краткое назначение

ssh-exec-mcp — MCP-сервер для безопасного выполнения SSH-операций из AI-клиента.

Бизнес-задача

Командам часто нужно проверять серверы, запускать команды, переносить файлы и открывать временные туннели. Проект превращает эти операции в типизированные инструменты, которые можно вызывать из agent workflow без ручного переключения между терминалами.

Техническое решение

Сервер поддерживает управление hosts, выполнение одиночных команд и скриптов, параллельный запуск на нескольких серверах, interactive PTY sessions, SFTP-передачу файлов, local port forwarding и сохраненные command templates.

Архитектура

• stdio MCP transport;
• SSH connection pool с повторным использованием соединений;
• host config и templates в локальном config;
• password, key и agent authentication;
• отдельные tool groups для hosts, exec, sessions, SFTP, tunnels и templates;
• логирование в stderr с маскированием secrets.

Стек

Node.js, TypeScript, MCP, ssh2, SFTP, PTY sessions, port forwarding.

Ограничения и риски

Инструменты удаленного управления требуют аккуратной модели доступа. Пароли и passphrases нельзя хранить в открытом репозитории; для production-сценариев предпочтительнее SSH key auth и env-based конфигурация.

Что показывает в портфолио

Infrastructure automation, AI-callable operations, безопасную работу с SSH, файловыми операциями, tunnels и server runbooks.

Ссылка

https://github.com/NohchiyBors/ssh-exec-mcp