SSH·tufantunc

SSH MCP — подключение и инструкция

SSH MCP позволяет агенту выполнять разрешённые команды и операции на заданных SSH-хостах через инструменты MCP.

РазработкаЛокальноAPI-ключ

Что умеет этот сервер

01

SSH MCP позволяет агенту выполнять разрешённые команды и операции на заданных SSH-хостах через инструменты MCP.

02

В актуальной v2 сервер может пройти handshake без настроек, но отклоняет рабочие вызовы до конфигурации.

03

Проверь соединение с тестовым хостом и выполни простую команду чтения.

Задача для знакомства

Через SSH MCP проверь только тестовый хост и покажи текущего пользователя и рабочий каталог. Файлы, сервисы и пакеты не меняй.

Уточнить результат

Сверь имя хоста, пользователя, cwd, exit code и stdout/stderr. После сетевого обрыва сначала выясни, завершилась ли команда, прежде чем повторять изменяющее действие.

Как подключить

Выберите подходящий способ

Подключить SSH MCP

Установи npm install -g ssh-mcp. Создай конфигурацию в пути своей ОС из Quick Start, задай хосты и доступы. Подключи command ssh-mcp в клиент; после правки конфигурации используй предусмотренный reload-config либо перезапуск.

Что понадобится

  • Node.js/npm, доступный SSH-хост и отдельная учётная запись. Нужны локальная конфигурация ssh-mcp и разрешённые способы аутентификации.
  1. 01

    Подготовь окружение

    Node.js/npm, доступный SSH-хост и отдельная учётная запись. Нужны локальная конфигурация ssh-mcp и разрешённые способы аутентификации.

  2. 02

    Установи и настрой

    Установи npm install -g ssh-mcp. Создай конфигурацию в пути своей ОС из Quick Start, задай хосты и доступы. Подключи command ssh-mcp в клиент; после правки конфигурации используй предусмотренный reload-config либо перезапуск.

  3. 03

    Открой новую сессию

    Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.

Команда подключения из документации

npm install -g ssh-mcp

Первый запрос — пример для чата агента

Через SSH MCP проверь только тестовый хост и покажи текущего пользователя и рабочий каталог. Файлы, сервисы и пакеты не меняй.

Как проверить

Сверь имя хоста, пользователя, cwd, exit code и stdout/stderr. После сетевого обрыва сначала выясни, завершилась ли команда, прежде чем повторять изменяющее действие.

Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.

README и установка автора

Что умеет SSH

SSH MCP позволяет агенту выполнять разрешённые команды и операции на заданных SSH-хостах через инструменты MCP.

В актуальной v2 сервер может пройти handshake без настроек, но отклоняет рабочие вызовы до конфигурации. Список видимых tools не означает, что доступ к хосту уже настроен.

Что подготовить перед подключением

Node.js/npm, доступный SSH-хост и отдельная учётная запись. Нужны локальная конфигурация ssh-mcp и разрешённые способы аутентификации.

Как установить и подключить

Установи npm install -g ssh-mcp. Создай конфигурацию в пути своей ОС из Quick Start, задай хосты и доступы. Подключи command ssh-mcp в клиент; после правки конфигурации используй предусмотренный reload-config либо перезапуск.

Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.

Как пользоваться: первый сценарий

Проверь соединение с тестовым хостом и выполни простую команду чтения. Всегда указывай host и рабочий каталог; изменения сервисов и файлов готовь отдельным планом.

Как проверить результат и решить проблемы

Сверь имя хоста, пользователя, cwd, exit code и stdout/stderr. После сетевого обрыва сначала выясни, завершилась ли команда, прежде чем повторять изменяющее действие.

Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.

Ограничения

SSH-команда выполняется на реальном хосте с правами учётной записи. Ограничения и доступные хосты задаются конфигурацией, а не пожеланием в обычном промпте.

Исходники и документация

Репозиторий: tufantunc/ssh-mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.

Другие подключения — в каталоге MCP-серверов Нейролюба.

Вопросы о SSH

SSH MCP позволяет агенту выполнять разрешённые команды и операции на заданных SSH-хостах через инструменты MCP.
Вернуться в библиотеку