# 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, подключение разрешено только к хостам из списка.