safe-ssh-mcp — MCP-сервер для Claude Code
MCP-сервер подключается к удалённым хостам по SSH и выполняет разрешённые команды для диагностики. Подходит для проверки диска, systemd и состояния системы.
claude mcp add safe-ssh-mcp -- uvx safe-ssh-mcpЧто делает safe-ssh-mcp
safe-ssh-mcp даёт агенту ограниченный набор диагностических SSH-инструментов вместо общего bash-доступа. Он умеет проверять свободное и занятое место, читать dmesg, uptime, дату и /etc/os-release, получать списки и статусы systemd, задания crontab и снимок top.
Подключение работает через пароль SSH или приватный ключ. Для ключа с passphrase можно выбрать переменную SSH_KEY_PASSPHRASE через ssh_key_passphrase_method=ENV_VAR либо KEYCHAIN с ssh-agent; настройки хранятся в mcp_config.ini. Сервер рассчитан на Python 3.11–3.14 и проверялся с удалённым Ubuntu.
Сервер предотвращает изменения на удалённой системе, но не гарантирует безопасное использование самого вывода внешним агентом. Это важно учитывать при передаче диагностических данных.
Какие задачи решает
- проверить свободное место на удалённом хосте
- найти занятые диском каталоги
- выявить упавшие службы
systemd - посмотреть активные таймеры и задания
cron - снять разовый снимок загрузки системы
Примеры запросов агенту
- Проверь свободное место на удалённом сервере через
safe-ssh-mcpи покажи проблемные разделы. - Посмотри упавшие службы
systemdи их статусы на хостеmyserver.mydomain.pro. - Сними диагностику диска для
/root/по SSH, используя ключ~/.ssh/id_rsa.
Как установить safe-ssh-mcp
Командой платформы
claude mcp add safe-ssh-mcp -- uvx safe-ssh-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from safe-ssh-mcp <команда>
Командой платформы
codex mcp add safe-ssh-mcp -- uvx safe-ssh-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from safe-ssh-mcp <команда>
Файл настроек
{
"mcpServers": {
"safe-ssh-mcp": {
"command": "uvx",
"args": [
"safe-ssh-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from safe-ssh-mcp <команда>
Файл настроек
{
"servers": {
"safe-ssh-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"safe-ssh-mcp"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from safe-ssh-mcp <команда>
Командой платформы
gemini mcp add safe-ssh-mcp uvx safe-ssh-mcpuvx запускает команду с именем пакета; если в README она другая — uvx --from safe-ssh-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о safe-ssh-mcp
Как установить safe-ssh-mcp в Claude Code?
Выполните claude mcp add safe-ssh-mcp -- uvx safe-ssh-mcp.
Что делает safe-ssh-mcp?
Он подключается к хосту по SSH и предоставляет агенту разрешённые read-only-команды для диагностики дисков, служб, загрузки и системных задач.
Какие способы SSH-аутентификации поддерживает сервер?
Пароль учётной записи и приватный ключ. Для passphrase доступны ENV_VAR через SSH_KEY_PASSPHRASE и KEYCHAIN через ssh-agent.
