Ellmos ServerCommander

Server operations MCP: HTTP health checks, log analysis, deploy dry-runs, mail diagnostics.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ellmos-servercommander": {
      "command": "npx",
      "args": [
        "-y",
        "invocation"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

ellmos-servercommander-mcp

Alpha Model Context Protocol (MCP) server for local-first server operations: deployment dry-runs, mail configuration status, access-log analysis, and resilient HTTP health checks.

German README: README_de.md

Part of the ellmos-ai family under the open-bricks open-source umbrella.

[!NOTE] Discoverability & AI Search: Published on npm as ellmos-servercommander-mcp, cataloged for MCP ecosystems in server.json, glama.json, and smithery.yaml, and indexed for AI/LLM search in llms.txt.

Architecture Visualized

mermaid

flowchart TD
    subgraph HostLayer ["1. MCP Host & AI Client Layer"]
        Host["MCP Host: Claude Desktop / Claude Code / Cursor"]
    end

    subgraph GatewayLayer ["2. Gateway & Process Supervision Layer"]
        NodeWrapper["Node.js CLI Wrapper (bin/ellmos-servercommander.js)"]
    end

    subgraph CoreLayer ["3. Python MCP Server Core Layer"]
        FastMCP["Python MCP Server (FastMCP Transport stdio)"]
        Dispatcher["Tool Dispatcher & Parameter Validator"]
        i18nEngine["i18n Translation Engine (en, de, es, zh, ja, ru)"]
    end

    subgraph OperationsLayer ["4. Operations & Diagnostics Engines"]
        HTTPProbe["HTTP Health Probe (sc_health_check)"]
        LogAnalyzer["Apache/Nginx Log Analyzer (sc_logs_analyze)"]
        DeployStaging["Deployment Staging & Manifest Planner (sc_deploy / sc_deploy_status)"]
        MailDiagnostics["IMAP/SMTP Safety Diagnostics (sc_mail_*)"]
    end

    subgraph SinkLayer ["5. Local Storage & Audit Sink Layer"]
        SQLiteHist[("Local SQLite Deploy History (deploy-history.db)")]
        JSONReports[("Sanitized JSON Log Reports")]
        AuditSink["Local Diagnostic Outputs & Stdout Stream"]
    end

    Host <-->|"stdio / JSON-RPC"| NodeWrapper
    NodeWrapper <-->|"Child Process Stdio"| FastMCP
    FastMCP --> Dispatcher
    Dispatcher <--> i18nEngine
    Dispatcher --> HTTPProbe
    Dispatcher --> LogAnalyzer
    Dispatcher --> DeployStaging
    Dispatcher --> MailDiagnostics
    DeployStaging -.->|"Optional opt-in persist"| SQLiteHist
    LogAnalyzer -.->|"Optional persist_report"| JSONReports
    HTTPProbe -.-> AuditSink
    MailDiagnostics -.-> AuditSink

Start Here

Goal	Start with	Key Features
Add ServerCommander to Claude Desktop, Claude Code, Cursor, or another MCP host	MCP Client Configuration	Zero-friction global npm install or npx invocation
Check a public or internal HTTP endpoint before a deploy	`sc_health_check`	Concurrent non-blocking requests, latency timings, resilient batch error handling
Inspect Apache/Nginx access logs for errors, bots, referrers, and suspicious paths	`sc_logs_analyze`	Status code breakdown, byte transfer sums, bot markers, optional JSON reports
Build a deterministic dry-run deployment manifest before SFTP/SSH execution	`sc_deploy` and `sc_deploy_status`	Recursive SHA-256 tree hashing, symlink bypass protection, SQLite history
Wire mail operations later without accidental email dispatches today	`sc_mail_list`, `sc_mail_read`, `sc_mail_send`, `sc_mail_search`	Protocol readiness validation, credential inspection, safe alpha staging

Key Capabilities & Safety Invariants

Capability / Invariant	Implementation Guarantee	Technical Details
100% Local-First & Dry-Run Staging	Strict non-destructive default	Deployment tools calculate SHA-256 hashes locally without executing unauthorized remote writes.
Unprivileged Execution (Non-Elevation)	Zero root/administrator requirements	Runs entirely within standard user permissions; never requires sudo or privilege elevation.
Secret & Credential Isolation	Zero-leak release packaging	`.env`, `.npmrc`, `.pypirc`, private keys (`id_rsa`, `*.pem`), and tokens are excluded by `.gitignore` and `.npmignore`.
Deterministic Manifest Verification	Cryptographic release integrity	Calculates recursive SHA-256 digests; nested symlinks are tracked but excluded from tree traversal.
Resilient Health Probes	Non-blocking batch worker threads	HTTP probes execute via `asyncio.to_thread` with strict timeouts; malformed URLs never abort batches.
Structured Log Breakdown	Local forensic inspection	Parses Common/Combined log formats; detects HTTP 4xx/5xx spikes, bots, suspicious traversal attempts.
Mail Readiness Diagnostic	Non-executing safe staging	Reuses verified `mail-connector` module for IMAP probes only when explicitly configured; SMTP send stays disabled.
6-Language i18n Engine	Comprehensive multilingual support	Full localization for tool descriptions, schema arguments, and errors in `en`, `de`, `es`, `zh`, `ja`, `ru`.

Status & Protocol Support

Transport: Standard I/O (stdio) via the Python MCP SDK and Node.js process wrapper.
Package Status: Public alpha package under the ellmos-ai organization.
Current Core: MCP tool listing, tool dispatch, TOML configuration loader, HTTP health checks, richer access-log analysis with optional persisted JSON reports, and optional local dry-run deployment history.
Safe Alpha Handlers: sc_deploy builds local SHA-256 manifests, configuration diagnostics, and opt-in SQLite history records in dry-run mode; sc_mail_* reports protocol-specific IMAP/SMTP readiness without opening mail connections by default.
i18n Localization: Localized MCP tool descriptions, input-schema field descriptions, and unknown-tool errors for en, de, es, zh, ja, ru with automatic English fallback.

Installation

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

Terminal

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

Option 2: Install From Source

powershell

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.

MCP Client Configuration

Global npm Install

config.json

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

npx Without Global Install

config.json

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

Direct Python Execution

config.json

{
  "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"
      }
    }
  }
}

Configuration & Profiles

ServerCommander searches for configuration files in this hierarchical order:

Environment variable SERVERCOMMANDER_CONFIG_PATH
./servercommander.toml
./config/servercommander.toml
~/.config/servercommander/servercommander.toml

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Ellmos ServerCommander

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ellmos-servercommander": { "command": "npx", "args": ["-y", "ellmos ServerCommander"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Ellmos ServerCommander AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ellmos-servercommander?style=directory)](https://allmcps.com/mcp/ellmos-servercommander)

HTML Embed

<a href="https://allmcps.com/mcp/ellmos-servercommander"><img src="https://allmcps.com/api/badge/ellmos-servercommander?style=directory" alt="Ellmos ServerCommander on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Ellmos ServerCommander →Install in Claude Desktop Install in Cursor Install in VS Code

Ellmos ServerCommander

Server operations MCP: HTTP health checks, log analysis, deploy dry-runs, mail diagnostics.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ellmos-servercommander": {
      "command": "npx",
      "args": [
        "-y",
        "invocation"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

ellmos-servercommander-mcp

Alpha Model Context Protocol (MCP) server for local-first server operations: deployment dry-runs, mail configuration status, access-log analysis, and resilient HTTP health checks.

German README: README_de.md

Part of the ellmos-ai family under the open-bricks open-source umbrella.

[!NOTE] Discoverability & AI Search: Published on npm as ellmos-servercommander-mcp, cataloged for MCP ecosystems in server.json, glama.json, and smithery.yaml, and indexed for AI/LLM search in llms.txt.

Quick Navigation

Architecture Visualized
Start Here
Key Capabilities & Safety Invariants
Status & Protocol Support
Installation
MCP Client Configuration
Configuration & Profiles
Tools & Handlers
End-to-End Operations Lifecycle
Search And Disambiguation
Sibling Ecosystem
Development & Verification
Security & Governance

Architecture Visualized

mermaid

flowchart TD
    subgraph HostLayer ["1. MCP Host & AI Client Layer"]
        Host["MCP Host: Claude Desktop / Claude Code / Cursor"]
    end

    subgraph GatewayLayer ["2. Gateway & Process Supervision Layer"]
        NodeWrapper["Node.js CLI Wrapper (bin/ellmos-servercommander.js)"]
    end

    subgraph CoreLayer ["3. Python MCP Server Core Layer"]
        FastMCP["Python MCP Server (FastMCP Transport stdio)"]
        Dispatcher["Tool Dispatcher & Parameter Validator"]
        i18nEngine["i18n Translation Engine (en, de, es, zh, ja, ru)"]
    end

    subgraph OperationsLayer ["4. Operations & Diagnostics Engines"]
        HTTPProbe["HTTP Health Probe (sc_health_check)"]
        LogAnalyzer["Apache/Nginx Log Analyzer (sc_logs_analyze)"]
        DeployStaging["Deployment Staging & Manifest Planner (sc_deploy / sc_deploy_status)"]
        MailDiagnostics["IMAP/SMTP Safety Diagnostics (sc_mail_*)"]
    end

    subgraph SinkLayer ["5. Local Storage & Audit Sink Layer"]
        SQLiteHist[("Local SQLite Deploy History (deploy-history.db)")]
        JSONReports[("Sanitized JSON Log Reports")]
        AuditSink["Local Diagnostic Outputs & Stdout Stream"]
    end

    Host <-->|"stdio / JSON-RPC"| NodeWrapper
    NodeWrapper <-->|"Child Process Stdio"| FastMCP
    FastMCP --> Dispatcher
    Dispatcher <--> i18nEngine
    Dispatcher --> HTTPProbe
    Dispatcher --> LogAnalyzer
    Dispatcher --> DeployStaging
    Dispatcher --> MailDiagnostics
    DeployStaging -.->|"Optional opt-in persist"| SQLiteHist
    LogAnalyzer -.->|"Optional persist_report"| JSONReports
    HTTPProbe -.-> AuditSink
    MailDiagnostics -.-> AuditSink

Start Here

Goal	Start with	Key Features
Add ServerCommander to Claude Desktop, Claude Code, Cursor, or another MCP host	MCP Client Configuration	Zero-friction global npm install or npx invocation
Check a public or internal HTTP endpoint before a deploy	`sc_health_check`	Concurrent non-blocking requests, latency timings, resilient batch error handling
Inspect Apache/Nginx access logs for errors, bots, referrers, and suspicious paths	`sc_logs_analyze`	Status code breakdown, byte transfer sums, bot markers, optional JSON reports
Build a deterministic dry-run deployment manifest before SFTP/SSH execution	`sc_deploy` and `sc_deploy_status`	Recursive SHA-256 tree hashing, symlink bypass protection, SQLite history
Wire mail operations later without accidental email dispatches today	`sc_mail_list`, `sc_mail_read`, `sc_mail_send`, `sc_mail_search`	Protocol readiness validation, credential inspection, safe alpha staging

Key Capabilities & Safety Invariants

Capability / Invariant	Implementation Guarantee	Technical Details
100% Local-First & Dry-Run Staging	Strict non-destructive default	Deployment tools calculate SHA-256 hashes locally without executing unauthorized remote writes.
Unprivileged Execution (Non-Elevation)	Zero root/administrator requirements	Runs entirely within standard user permissions; never requires sudo or privilege elevation.
Secret & Credential Isolation	Zero-leak release packaging	`.env`, `.npmrc`, `.pypirc`, private keys (`id_rsa`, `*.pem`), and tokens are excluded by `.gitignore` and `.npmignore`.
Deterministic Manifest Verification	Cryptographic release integrity	Calculates recursive SHA-256 digests; nested symlinks are tracked but excluded from tree traversal.
Resilient Health Probes	Non-blocking batch worker threads	HTTP probes execute via `asyncio.to_thread` with strict timeouts; malformed URLs never abort batches.
Structured Log Breakdown	Local forensic inspection	Parses Common/Combined log formats; detects HTTP 4xx/5xx spikes, bots, suspicious traversal attempts.
Mail Readiness Diagnostic	Non-executing safe staging	Reuses verified `mail-connector` module for IMAP probes only when explicitly configured; SMTP send stays disabled.
6-Language i18n Engine	Comprehensive multilingual support	Full localization for tool descriptions, schema arguments, and errors in `en`, `de`, `es`, `zh`, `ja`, `ru`.

Status & Protocol Support

Transport: Standard I/O (stdio) via the Python MCP SDK and Node.js process wrapper.
Package Status: Public alpha package under the ellmos-ai organization.
Current Core: MCP tool listing, tool dispatch, TOML configuration loader, HTTP health checks, richer access-log analysis with optional persisted JSON reports, and optional local dry-run deployment history.
Safe Alpha Handlers: sc_deploy builds local SHA-256 manifests, configuration diagnostics, and opt-in SQLite history records in dry-run mode; sc_mail_* reports protocol-specific IMAP/SMTP readiness without opening mail connections by default.
i18n Localization: Localized MCP tool descriptions, input-schema field descriptions, and unknown-tool errors for en, de, es, zh, ja, ru with automatic English fallback.

Installation

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

Terminal

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

Option 2: Install From Source

powershell

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.

MCP Client Configuration

Global npm Install

config.json

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

npx Without Global Install

config.json

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

Direct Python Execution

config.json

{
  "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"
      }
    }
  }
}

Configuration & Profiles

ServerCommander searches for configuration files in this hierarchical order:

Environment variable SERVERCOMMANDER_CONFIG_PATH
./servercommander.toml
./config/servercommander.toml
~/.config/servercommander/servercommander.toml

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Ellmos ServerCommander

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ellmos-servercommander": { "command": "npx", "args": ["-y", "ellmos ServerCommander"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ellmos-servercommander?style=directory)](https://allmcps.com/mcp/ellmos-servercommander)

HTML Embed

<a href="https://allmcps.com/mcp/ellmos-servercommander"><img src="https://allmcps.com/api/badge/ellmos-servercommander?style=directory" alt="Ellmos ServerCommander on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

36Quality signal: Fair · 36/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Ellmos ServerCommander →Install in Claude Desktop Install in Cursor Install in VS Code