convez.ai
MCP Server
ellmos-ai

ellmos-servercommander-mcp

ellmos-ai/ellmos-servercommander-mcp

Ver no GitHub
BomPluginScore · de 0 a 100

Local-first MCP server for server operations: HTTP health checks, Apache/Nginx log analysis, dry-run deploy manifests and mail diagnostics

Instalação

$npx convez-ai ellmos-ai/ellmos-servercommander-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 5 dias
Versão
—
Issues abertas
1
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

ellmos-servercommander-mcp

Alpha MCP server for server operations: deployment dry-runs, mail status, access-log analysis, and HTTP health checks.

German README: README_de.md

Part of the ellmos-ai family.

License: MIT npm version Python Node.js MCP Status: alpha

Discoverability: Published on npm as ellmos-servercommander-mcp, described for MCP catalogs in server.json, and summarized for AI search/indexing in llms.txt.

Start Here

GoalStart with
Add ServerCommander to Claude Desktop, Claude Code, Cursor, or another MCP hostMCP Client Configuration
Check a public or internal HTTP endpoint before a deploysc_health_check
Inspect Apache/Nginx access logs for errors, bots, referrers, and suspicious pathssc_logs_analyze
Build a dry-run deployment manifest before SFTP/SSH execution existssc_deploy and sc_deploy_status
Wire mail operations later without accidental sends todaysc_mail_list, sc_mail_read, sc_mail_send, sc_mail_search

Status

  • Transport: stdio via the Python MCP SDK
  • Package status: public alpha package under ellmos-ai
  • Current core: MCP tool listing, MCP tool dispatch, config loading, HTTP health checks, richer access-log analysis with optional persisted JSON reports
  • Safe alpha handlers: sc_deploy builds local SHA256 manifests and configuration diagnostics in dry-run mode; sc_mail_* reports mail configuration gaps without IMAP/SMTP operations
  • i18n: localized MCP tool descriptions, input-schema field descriptions, and unknown-tool errors for en, de, es, zh, ja, ru with English fallback

Install

The npm package contains a Node wrapper that starts the Python server. You still need Python 3.10+ and the Python package mcp>=1.0.0.

Option 1: Install From npm

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

Option 2: Install From Source

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

Avoid creating a .venv inside cloud-synced folders if your sync client locks files. If you need an isolated environment, create it outside that folder.

Start From Source

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

MCP Client Configuration

Global npm Install

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

Source Checkout

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

Replace /absolute/path/to/ellmos-servercommander-mcp with your local checkout path.

Server Configuration

Example: config/servercommander.example.toml

Default paths:

  • %USERPROFILE%\.servercommander\config.toml
  • %USERPROFILE%\.config\servercommander\config.toml
  • override with SERVERCOMMANDER_CONFIG

Language can be configured with [server].language, SERVERCOMMANDER_LANG, or SERVERCOMMANDER_LOCALE.

[server]
name = "ellmos-servercommander"
language = "en" # en, de, es, zh, ja, ru

[logs]
default_format = "apache" # apache | nginx
persist_reports = false
reports_dir = "~/.servercommander/log_reports"

Secrets should be referenced through environment variables, for example $MAIL_PASSWORD or $SFTP_PASSWORD.

Tools

  • sc_health_check: checks HTTP endpoints and reports status code plus latency
  • sc_logs_analyze: analyzes Apache/Nginx access logs from inline text or a local file, including status classes, bytes, referers, error paths, suspicious request markers, and optional JSON report persistence via persist_report
  • sc_deploy: creates a deployment plan with a local SHA256 manifest and profile diagnostics, but does not upload yet
  • sc_deploy_status: shows configured deploy profiles, selected-profile diagnostics, and the current alpha history status
  • sc_mail_list, sc_mail_read, sc_mail_send, sc_mail_search: safe alpha status responses with mail configuration diagnostics and no IMAP/SMTP connections

Search And Disambiguation

ServerCommander is the ellmos operations MCP server for local-first server administration workflows. Use this repo when searching for:

  • MCP server operations tools
  • MCP deploy dry-run server
  • MCP access log analyzer
  • MCP HTTP health check tool
  • local-first server management MCP
  • Claude Code server operations MCP
  • safe SFTP deployment planning MCP

It is not the GitHub MCP server, not a generic shell-command MCP server, not a hosting provider control panel, and not a production SFTP/IMAP executor yet. The current alpha surface is intentionally diagnostic and dry-run first.

ellmos MCP Family

Development

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

Next useful step: add explicitly configured execution adapters for SFTP and IMAP/SMTP while keeping dry-run/status-only defaults.

Ver o original no GitHub

Bom para

Relacionados