ellmos-servercommander-mcp

Servidor MCP en fase alfa para operaciones de servidor: simulaciones de despliegue, estado del correo, análisis de registros de acceso y comprobaciones de salud HTTP.

README en alemán: README_de.md

Parte de la familia ellmos-ai.

[!NOTA] Descubribilidad y búsqueda con IA: Publicado en npm como ellmos-servercommander-mcp, catalogado para ecosistemas MCP en server.json, glama.json y smithery.yaml, e indexado para búsqueda con IA/LLM en llms.txt.

Arquitectura visualizada

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

Comience aquí

Estado

• Transporte: stdio mediante el SDK MCP de Python

• Estado del paquete: paquete público en fase alfa bajo ellmos-ai

• Núcleo actual: listado de herramientas MCP, envío de herramientas MCP, carga de configuración, comprobaciones de salud HTTP, análisis más completo de registros de acceso con informes JSON opcionales persistentes e historial opcional de despliegues en seco local

• Manejadores seguros en alfa: sc_deploy crea manifiestos SHA256 locales, diagnósticos de configuración y registros opcionales en SQLite en modo seco; sc_mail_* informa de la preparación IMAP/SMTP específica del protocolo sin abrir conexiones de correo

• i18n: descripciones de herramientas MCP localizadas, descripciones de campos del esquema de entrada y errores de herramienta desconocida para en, de, es, zh, ja, ru con fallback al inglés

Instalación

El paquete npm contiene un envoltorio Node que inicia el servidor Python. Aún necesita Python 3.10+ y el paquete Python mcp>=1.0.0.

Opción 1: Instalar desde npm

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

Opción 2: Instalar desde el código fuente

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

Evite crear un .venv dentro de carpetas sincronizadas en la nube si su cliente de sincronización bloquea archivos. Si necesita un entorno aislado, créelo fuera de esa carpeta.

Iniciar desde el código fuente

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

Configuración del cliente MCP

Instalación global de npm

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

npx sin instalación global

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

Ejecución directa de 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"
      }
    }
  }
}

Configuración

ServerCommander busca la configuración en este orden:

1. Variable de entorno SERVERCOMMANDER_CONFIG_PATH

2. ./servercommander.toml

3. ./config/servercommander.toml

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

Se incluye una plantilla anotada en 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

Los secretos deben referenciarse mediante variables de entorno, por ejemplo $MAIL_PASSWORD o $SFTP_PASSWORD.

Herramientas

• sc_health_check: comprueba endpoints HTTP y devuelve el código de estado más la latencia; las URL de endpoint mal formadas se devuelven como comprobaciones fallidas, de modo que una entrada incorrecta no interrumpe un lote

• sc_logs_analyze: analiza registros de acceso de Apache/Nginx desde texto en línea o un archivo local, incluyendo clases de estado, bytes, referentes, rutas de error, marcadores de solicitudes sospechosas y persistencia opcional de informes JSON mediante persist_report

• sc_deploy: crea un plan de despliegue con un manifiesto SHA256 local y diagnósticos de perfil, pero aún no sube; las comprobaciones de preparación verifican campos obligatorios, rutas locales manifestables y protocolos compatibles antes de record_history=true opcional; los enlaces simbólicos anidados se notifican pero se excluyen para que un manifiesto no pueda atravesar silenciosamente más allá del directorio de lanzamiento seleccionado

• sc_deploy_status: muestra los perfiles de despliegue configurados, diagnósticos del perfil seleccionado e historial reciente de simulaciones desde la base de datos SQLite local

• sc_mail_list, sc_mail_read, sc_mail_send, sc_mail_search: respuestas de estado alfa seguras con diagnósticos de preparación IMAP/SMTP específicos de la acción y sin conexiones de correo por defecto. Con [mail].execution_enabled = true, sc_mail_list ejecuta una sonda de alcance IMAP de solo lectura en vivo (conectar + listar carpetas) reutilizando el módulo canónico mail-connector — no reimplementa un cliente IMAP; la lectura/búsqueda a nivel de mensaje siguen siendo dominio de mail-connector, y el envío SMTP permanece sin ejecución

Búsqueda y desambiguación

ServerCommander es el servidor MCP de operaciones de ellmos para flujos de trabajo de administración de servidores locales. Use este repositorio cuando busque:

• Herramientas de operaciones de servidor MCP

• Servidor MCP de simulación de despliegue

• Analizador de registros de acceso MCP

• Herramienta de comprobación de salud HTTP MCP

• Gestión de servidores local primero MCP

• MCP de operaciones de servidor para Claude Code

• MCP de planificación de despliegue SFTP seguro

No es el servidor MCP de GitHub, no es un servidor MCP de comandos shell genérico, no es un panel de control de proveedor de alojamiento y no es un ejecutor de SFTP/IMAP en producción. La superficie alfa actual es intencionadamente diagnóstica y de simulación primero.

Ecosistema ellmos-ai

Este servidor MCP forma parte del ecosistema ellmos-ai — infraestructura de IA, servidores MCP y herramientas inteligentes.

Familia de servidores MCP

Infraestructura de IA y herramientas para desarrolladores

Software de Escritorio

Nuestra organización colaboradora open-bricks agrupa aplicaciones de escritorio nativas de IA — un conjunto de software moderno y de código abierto construido para la era de la IA. Las categorías incluyen gestión de archivos (ProFiler), herramientas documentales (DokuZen, PDFtoPDFocr), utilidades para desarrolladores (DevCenter, CodeBox) y más.

Desarrollo

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

Próximo paso útil: agregar adaptadores de ejecución configurados explícitamente para SFTP e IMAP/SMTP, manteniendo las opciones predeterminadas de simulación/solo estado.