ssh-mcp — MCP-сервер для Claude Code: что делает и как установить
Централизованный шлюз для контролируемого доступа ИИ-агентов к серверам по SSH с разделением прав по токенам, журналом аудита и лимитами запросов.
Открыть на GitHubЧто делает ssh-mcp
Шлюз запускается в Docker и принимает вызовы от ИИ-клиентов по протоколу Streamable HTTP. Вместо раздачи ключей каждому агенту администратор настраивает единый список хостов в ssh-mcp-config.json и связывает токены с разрешёнными командами. Внутри работают пул соединений, размыкатель цепи при сбоях узлов и ограничение частоты запросов.
Агенту доступны шесть инструментов линейки ssh_*: проверка связи, просмотр доступных серверов и команд, запуск процессов, а также загрузка и выгрузка файлов через SFTP. Интерактивную оболочку сервис не поддерживает. Передача файлов работает строго поштучно, без каталогов и рекурсивных обходов.
Встроенного TLS-терминатора в контейнере нет, поэтому перед выходом в публичную сеть придётся настроить Traefik или nginx.
Какие задачи решает
- централизовать выдачу SSH-доступа агентам без копирования ключей
- ограничить разрешённые команды для удалённых серверов
- изолировать сбоящие целевые узлы через механизм circuit breaker
- фиксировать действия клиентов в структурированном журнале аудита
- передавать отдельные файлы на удалённый хост через SFTP
Примеры запросов агенту
- Проверь доступность сервера
my-serverчерезssh_check_connection - Выполни команду
uptimeна хостеmy-serverс помощьюssh_execute_command - Скачай файл
/var/log/app.logс сервера черезssh_download_file
Как установить ssh-mcp
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ssh-mcp
Как запустить и подключить ssh-mcp для Claude Code?
Сервер разворачивают в Docker командами docker compose pull и docker compose up -d. Клиент подключается по протоколу Streamable HTTP к адресу http://host:9080/mcp с передачей API-ключа в заголовке X-API-Key или Authorization: Bearer.
Что делает ssh-mcp?
Сервис работает единой точкой входа между агентами и целевыми машинами по SSH. Он сопоставляет запросы с белым списком разрешённых команд, ведёт аудит в JSONL и изолирует упавшие узлы.
Поддерживает ли сервер интерактивный терминал?
Нет, интерактивные shell-сессии исключены из соображений безопасности. Команды выполняются строго по одной с возвратом структурированного вывода.
