mcp-ssh

MCP сервер для подключения по SSH и выполнения команд на удалённом сервере.

Быстрый старт

1. Установите зависимости:

• npm install

2. Создайте .env на основе .env.example и задайте параметры подключения.

3. Запустите в режиме разработки:

• npm run dev

Или соберите и запустите:

• npm run build
• npm start

Запуск через docker-compose

1. Создайте .env на основе .env.example.

2. Запустите сервис:

• docker compose up -d

Сервис работает по stdio (MCP), проброс портов не требуется.

Доступные инструменты MCP

ssh_connect

Создаёт SSH сессию.

Параметры:

• host (string, optional)
• port (number, optional)
• username (string, optional)
• privateKey (string, optional)
• privateKeyPath (string, optional)
• password (string, optional)
• connectTimeoutMs (number, optional)

Возвращает: sessionId, host, port, username.

ssh_exec

Выполняет команду в существующей сессии.

Параметры:

• sessionId (string)
• command (string)
• cwd (string, optional)
• timeoutMs (number, optional)

Возвращает: stdout, stderr, exitCode, exitSignal.

ssh_disconnect

Закрывает сессию.

Параметры:

• sessionId (string)

Возвращает: disconnected.

ssh_list_sessions

Возвращает список активных сессий.

Ограничение хостов

Если задан MCP_SSH_ALLOWED_HOSTS, подключение разрешено только к хостам из списка.