ellmos-servercommander-mcp

用于服务器操作的 Alpha MCP 服务器：部署预演、邮件状态、访问日志分析及 HTTP 健康检查。

德文 README: README_de.md

属于 ellmos-ai 家族的一部分。

[!NOTE] 可发现性与 AI 搜索： 已发布至 npm 作为 ellmos-servercommander-mcp，在 server.json、glama.json 和 smithery.yaml 中为 MCP 生态系统编目，并在 llms.txt 中为 AI/LLM 搜索建立索引。

架构可视化

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

从这里开始

状态

• 传输：通过 Python MCP SDK 的 stdio

• 包状态：ellmos-ai 下的公开 alpha 包

• 当前核心：MCP 工具列表、MCP 工具分发、配置加载、HTTP 健康检查、更丰富的访问日志分析（可选持久化 JSON 报告），以及可选的本机预演部署历史

• 安全的 alpha 处理程序：sc_deploy 构建本机 SHA256 清单、配置诊断，以及在预演模式下可选的 SQLite 历史记录；sc_mail_* 报告协议特定的 IMAP/SMTP 就绪状态，而不打开邮件连接

• i18n：支持 en、de、es、zh、ja、ru 的本地化 MCP 工具描述、输入架构字段描述和未知工具错误，英语为回退

安装

npm 包包含一个启动 Python 服务器的 Node 封装器。您仍然需要 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 访问日志，包括状态类别、字节数、引用来源、错误路径、可疑请求标记，以及通过 persist_report 可选持久化 JSON 报告

• sc_deploy：创建部署计划，包含本机 SHA256 清单和配置文件诊断，但不会上传；在可选的 record_history=true 之前，就绪性检查会验证必填字段、可清单化的本地路径和支持的协议；嵌套符号链接会被报告但排除，因此清单不会静默遍历超出所选发布目录

• sc_deploy_status：显示已配置的部署配置文件、所选配置文件的诊断信息，以及来自本机 SQLite 历史数据库的最近预演历史

• sc_mail_list、sc_mail_read、sc_mail_send、sc_mail_search：安全的 alpha 状态响应，带有特定于操作的 IMAP/SMTP 就绪诊断，默认不打开邮件连接。当 [mail].execution_enabled = true 时，sc_mail_list 通过重用规范的 mail-connector 模块执行实时的只读 IMAP 可达性探测（连接 + 列出文件夹）——它不会重新实现 IMAP 客户端；消息级别的读取/搜索仍属于 mail-connector 的领域，SMTP 发送保持不执行

搜索与消歧

ServerCommander 是用于本地优先的服务器管理工作流的 ellmos 操作 MCP 服务器。当搜索以下内容时使用此仓库：

• MCP 服务器操作工具

• MCP 部署预演服务器

• MCP 访问日志分析器

• MCP HTTP 健康检查工具

• 本地优先的服务器管理 MCP

• Claude Code 服务器操作 MCP

• 安全的 SFTP 部署规划 MCP

它不是 GitHub MCP 服务器，不是通用的 shell 命令 MCP 服务器，不是托管提供商控制面板，也不是生产环境的 SFTP/IMAP 执行器。当前的 alpha 功能故意以诊断和预演优先。

ellmos-ai 生态系统

此 MCP 服务器是 ellmos-ai 生态系统的一部分——AI 基础设施、MCP 服务器和智能工具。

MCP 服务器家族

AI 基础设施与开发者工具

桌面软件

我们的合作伙伴组织 open-bricks 打包了AI原生桌面应用——一套为AI时代打造的现代开源软件套件。类别包括文件管理（ProFiler）、文档工具（DokuZen、PDFtoPDFocr）、开发者工具（DevCenter、CodeBox）等。

开发

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

下一步有用的步骤：添加显式配置的执行适配器，用于SFTP和IMAP/SMTP，同时保留干运行/仅状态默认值。