ellmos-servercommander-mcp

Альфа MCP-сервер для серверных операций: пробные развертывания (dry-run), статус почты, анализ логов доступа и HTTP-проверки работоспособности.

Немецкая версия README: README_de.md

Часть семейства ellmos-ai.

[!NOTE] Обнаруживаемость и AI-поиск: Опубликован на npm как ellmos-servercommander-mcp, каталогизирован для MCP-экосистем в server.json, glama.json и smithery.yaml, а также проиндексирован для AI/LLM-поиска в llms.txt.

Архитектура в визуальном представлении

graph TD
    Client[MCP Host: Claude / Cursor] <-->|stdio / JSON-RPC| NodeWrapper[Node.js Entrypoint]
    NodeWrapper <-->|Spawn subprocess| PyServer[Python MCP Server]
    
    subgraph Tools [ServerCommander Tools]
        PyServer -->|sc_health_check| HTTP[HTTP/HTTPS Endpoint Check]
        PyServer -->|sc_logs_analyze| Logs[Apache/Nginx Access Logs]
        PyServer -->|sc_deploy / sc_deploy_status| Deploy[Dry-Run Manifest & SQLite History]
        PyServer -->|sc_mail_*| Mail[IMAP/SMTP Safe Readiness Diagnostics]
    end
    
    subgraph Storage [Local Storage]
        Deploy -->|Optional persist| SQLite[(SQLite Deploy History)]
        Logs -->|Optional persist| JSONReports[(JSON Log Reports)]
    end

Related MCP server: automation-health-mcp

Начните здесь

Статус

• Транспорт: stdio через Python MCP SDK

• Статус пакета: публичный альфа-пакет в составе ellmos-ai

• Текущее ядро: список MCP-инструментов, диспетчеризация MCP-инструментов, загрузка конфигурации, HTTP-проверки работоспособности, расширенный анализ логов доступа с возможностью сохранения отчетов в JSON, а также опциональная локальная история пробных развертываний

• Безопасные альфа-обработчики: sc_deploy создает локальные SHA256-манифесты, диагностику конфигурации и опциональные записи в SQLite в режиме dry-run; sc_mail_* сообщает о готовности к IMAP/SMTP с учетом протокола без открытия почтовых соединений

• i18n: локализованные описания MCP-инструментов, описания полей входной схемы и сообщения об ошибках неизвестного инструмента для en, de, es, zh, ja, ru с запасным вариантом на английском

Установка

Пакет npm содержит Node-обёртку, которая запускает Python-сервер. Вам всё равно понадобятся Python 3.10+ и Python-пакет mcp>=1.0.0.

Вариант 1: Установка из npm

npm install -g ellmos-servercommander-mcp@alpha
ellmos-servercommander

Вариант 2: Установка из исходников

git clone https://github.com/ellmos-ai/ellmos-servercommander-mcp.git
cd ellmos-servercommander-mcp
$env:PYTHONIOENCODING = "utf-8"
python -m pip install -e ".[dev]"
python -m pytest -q

Избегайте создания .venv в папках, синхронизируемых с облаком, если ваш клиент синхронизации блокирует файлы. Если вам нужно изолированное окружение, создайте его за пределами этой папки.

Запуск из исходников

$env:PYTHONPATH = "src"
python -m servercommander.server

Настройка MCP-клиента

Глобальная установка через npm

{
  "mcpServers": {
    "servercommander": {
      "command": "ellmos-servercommander"
    }
  }
}

Использование npx без глобальной установки

{
  "mcpServers": {
    "servercommander": {
      "command": "npx",
      "args": ["-y", "ellmos-servercommander-mcp@alpha"]
    }
  }
}

Прямой запуск Python

{
  "mcpServers": {
    "servercommander": {
      "command": "python",
      "args": ["-m", "servercommander.server"],
      "env": {
        "PYTHONPATH": "C:/path/to/ellmos-servercommander-mcp/src",
        "SERVERCOMMANDER_CONFIG_PATH": "C:/path/to/config/servercommander.toml"
      }
    }
  }
}

Конфигурация

ServerCommander ищет конфигурацию в следующем порядке:

1. Переменная окружения SERVERCOMMANDER_CONFIG_PATH

2. ./servercommander.toml

3. ./config/servercommander.toml

4. ~/.config/servercommander/servercommander.toml

Аннотированный шаблон включён в config/servercommander.example.toml.

[server]
name = "servercommander"
log_level = "INFO"
language = "en"

[deploy.profiles.staging]
target = "sftp://staging.example.com/var/www/app"
local_path = "./dist"
protocol = "sftp"
dry_run = true
record_history = true

[mail]
execution_enabled = false
smtp_host = "smtp.example.com"
smtp_port = 587
imap_host = "imap.example.com"
imap_port = 993

Секреты следует указывать через переменные окружения, например $MAIL_PASSWORD или $SFTP_PASSWORD.

Инструменты

• sc_health_check: проверяет HTTP-конечные точки и сообщает код состояния и задержку; некорректные URL конечных точек возвращаются как неудачные проверки, поэтому один плохой ввод не прерывает пакетную обработку

• sc_logs_analyze: анализирует логи доступа Apache/Nginx из встроенного текста или локального файла, включая классы статусов, байты, рефереры, пути с ошибками, маркеры подозрительных запросов и опциональное сохранение JSON-отчёта через persist_report

• sc_deploy: создаёт план развёртывания с локальным SHA256-манифестом и диагностикой профиля, но не выполняет загрузку; проверки готовности требуют поля, манифестируемые локальные пути и поддерживаемые протоколы перед опциональным record_history=true; вложенные симлинки сообщаются, но исключаются, чтобы манифест не мог незаметно выйти за пределы выбранного каталога релиза

• sc_deploy_status: показывает настроенные профили развёртывания, диагностику выбранного профиля и недавнюю историю dry-run из локальной базы данных SQLite

• sc_mail_list, sc_mail_read, sc_mail_send, sc_mail_search: безопасные альфа-ответы с диагностикой готовности к IMAP/SMTP для конкретного действия и без почтовых соединений по умолчанию. При [mail].execution_enabled = true sc_mail_list выполняет живую, только для чтения проверку доступности IMAP (подключение + список папок), повторно используя канонический модуль mail-connector — он не перереализует IMAP-клиент; чтение/поиск на уровне сообщений остаются в ведении mail-connector, а отправка SMTP остаётся невыполняемой

Поиск и устранение неоднозначности

ServerCommander — это MCP-сервер операций ellmos для локальных рабочих процессов администрирования серверов. Используйте этот репозиторий при поиске:

• MCP-сервер инструментов для серверных операций

• MCP-сервер для пробного развёртывания (dry-run)

• MCP-анализатор логов доступа

• MCP-инструмент проверки HTTP-работоспособности

• локально-ориентированный MCP для управления сервером

• MCP для серверных операций в Claude Code

• MCP для безопасного планирования SFTP-развёртывания

Это не MCP-сервер GitHub, не универсальный MCP-сервер команд оболочки, не панель управления хостинг-провайдера и не исполнитель SFTP/IMAP в продакшене. Текущая альфа-поверхность намеренно диагностическая и ориентирована на пробные запуски.

Экосистема ellmos-ai

Этот MCP-сервер является частью экосистемы ellmos-ai — AI-инфраструктура, MCP-серверы и интеллектуальные инструменты.

Семейство MCP-серверов

AI-инфраструктура и инструменты для разработчиков

Настольное ПО

Наша партнёрская организация open-bricks объединяет AI-нативные настольные приложения — современный пакет открытого ПО, созданный для эпохи ИИ. Категории включают управление файлами (ProFiler), инструменты для документов (DokuZen, PDFtoPDFocr), утилиты для разработчиков (DevCenter, CodeBox) и другие.

Разработка

$env:PYTHONIOENCODING = "utf-8"
python -m pytest -q
npm run smoke
npm pack --dry-run

Следующий полезный шаг: явно настроенные адаптеры выполнения для SFTP и IMAP/SMTP с сохранением значений по умолчанию для сухого прогона/только статуса.