mcpField
E
ellmos ServerCommander

ellmos ServerCommander

本地服务
github.com云与基础设施14 周前更新

关于 ellmos ServerCommander

ellmos ServerCommander 是面向 AI 编码助手和系统运维人员的本地优先 MCP 服务,用于日常服务器诊断。它提供 HTTP 检查、访问日志分析、邮件就绪检查和部署试运行,默认采用非破坏性操作。

主要功能

  1. 01HTTP 健康检查
  2. 02访问日志分析
  3. 03邮件配置就绪检查
  4. 04部署试运行清单
  5. 05SHA-256 文件树哈希
  6. 06本地部署历史记录

适用场景

  1. 01部署前检查端点
  2. 02从日志中查找错误或可疑流量
  3. 03验证邮件配置而不发送邮件
  4. 04传输前准备部署清单

MCP 相关

它通过 stdio 向 MCP 客户端提供服务器诊断和部署规划工具。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"ellmos-ai-ellmos-servercommander": {
"command": "npx",
"args": [
"-y",
"ellmos-servercommander-mcp"
]
}
}
}
启动命令npx -y ellmos-servercommander-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmellmos-servercommander-mcp0.1.0-alpha.20

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

ellmos ServerCommander MCP 徽标

ellmos-servercommander-mcp

用于本地优先服务器运维的 Alpha Model Context Protocol (MCP) 服务:部署试运行、邮件配置状态、访问日志分析和弹性 HTTP 健康检查。

德语版 README:README_de.md

隶属于 ellmos-ai 系列,该系列由 open-bricks 开源项目群支持。

License: MIT npm version CI Pytest Python Node.js Platforms MCP Status: alpha Privacy: Local-First RunAsInvoker Third-Party: Level 1 SBOM Contributing: Guide Verified: 2026-10-02 Marketing: Log Security: Bilingual Policy Ecosystem: ellmos--ai open-bricks LLM--Ready: llms.txt

说明

**可发现性与 AI 搜索:**已在 npm 上发布,包名为 ellmos-servercommander-mcp;已在 server.json、glama.json 和 smithery.yaml 中编入 MCP 生态目录,并通过 llms.txt 编入 AI/大模型搜索索引。


快速导航

  1. 执行摘要与核心定位
  2. 可视化架构与系统拓扑
  3. 运维生命周期与执行序列流程
  4. 目标用户画像与高意向 SEO 查询
  5. 与替代方案的对比矩阵
  6. 核心能力与安全不变量
  7. 从这里开始与快速指南
  8. 状态与协议支持
  9. 安装与先决条件
  10. MCP 客户端配置与部署模式
  11. 配置与配置档规范
  12. 工具与处理程序参考
  13. 搜索、消歧与发现关键词
  14. 同类生态矩阵
  15. 第三方许可证与一级 SBOM
  16. 安全策略与运行限制(48h SLA)
  17. 开发、验证与 CI 矩阵
  18. 法定声明、责任限制与许可证(§ 521 BGB)

1. 执行摘要与核心定位

ellmos-servercommander-mcp 是一款权威的、本地优先的模型上下文协议(MCP)服务,专为 AI 编码助手和自主 Agent 平台(Claude Code、Cursor、Codex、Antigravity、Gemini)打造。它使 Agent 能够安全地诊断服务器运行状况、分析 Web 服务器访问日志、检查邮件就绪情况并构建试运行部署计划,同时避免将生产基础设施暴露于未经验证的破坏性变更或任意 Shell 执行之下。

每项操作都遵循严格的本地优先和零提权保证:

  • **默认 100% 本地优先且零外传:**诊断解析和清单哈希在本地执行;不进行遥测,也不发起未经验证的出站网络请求。
  • **先试运行、后暂存:**部署操作会计算 SHA-256 树摘要,并在暂存任何远程命令之前检查目标配置档。
  • **非特权执行(RunAsInvoker):**在标准非特权用户空间中运行,无需 root 或管理员权限。

2. 可视化架构与系统拓扑

下图展示了 ServerCommander 的解耦层,包括 MCP 主机传输、Node.js 进程监控、Python 调度、运维引擎和本地持久化接收端:

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
ASCII 架构拓扑(四视图投影)
========================================================================================
             ellmos-servercommander-mcp: Four-View Architectural Topology
========================================================================================

[VIEW 1: COMPONENT STRUCTURE & TRANSPORT BOUNDARIES]
  +----------------------------------------------------------------------------------+
  | 1. MCP Host & AI Client (Claude Desktop / Claude Code / Cursor / Codex)          |
  |    - Stdio JSON-RPC transport protocol                                           |
  +----------------------------------------------------------------------------------+
                                           |
                                           | (JSON-RPC via stdio stream)
                                           v
  +----------------------------------------------------------------------------------+
  | 2. Gateway & Process Supervision (bin/ellmos-servercommander.js)                 |
  |    - Node.js CLI launcher & process supervisor (update-notifier checks)          |
  |    - Working directory isolation: PYTHONSAFEPATH=1 prevents rogue import hijack  |
  +----------------------------------------------------------------------------------+
                                           |
                                           | (Supervised child process stdio)
                                           v
  +----------------------------------------------------------------------------------+
  | 3. FastMCP Dispatcher & i18n Localization Engine (src/servercommander/)          |
  |    - FastMCP server lifecycle, tool schema generation & parameter validation     |
  |    - Multi-language localization engine (6 locales: en, de, es, zh, ja, ru)      |
  +----------------------------------------------------------------------------------+

[VIEW 2: OPERATIONAL ENGINES & DRY-RUN EXECUTION]
  +----------------------------------------------------------------------------------+
  | 4. Tool Handlers & Diagnostic Engines                                            |
  |    - sc_health_check: Non-blocking HTTP/HTTPS probe with timeout & batch error   |
  |    - sc_logs_analyze: Sanitized Apache/Nginx access-log parser & threat detector|
  |    - sc_deploy / sc_deploy_status: Fail-safe SHA-256 tree hashing & dry-run plan|
  |    - sc_mail_list / sc_mail_read / sc_mail_send: Dry-run IMAP/SMTP diagnostics  |
  +----------------------------------------------------------------------------------+

[VIEW 3: LOCAL PERSISTENCE & CONCURRENCY MODEL]
  +----------------------------------------------------------------------------------+
  | 5. Local Storage & Audit Sinks                                                   |
  |    - Local SQLite Deploy History (deploy-history.db) with explicit lease release |
  |    - Sanitized JSON diagnostic reports (optional persist_report)                 |
  |    - Thread-isolated HTTP GET workers preventing event-loop stalling             |
  +----------------------------------------------------------------------------------+

[VIEW 4: SECURITY BOUNDARY & ZERO-EGRESS PERIMETER]
  +----------------------------------------------------------------------------------+
  | 6. Governance & Defense Invariants (INV-LOCAL-01 through INV-SLA-10)             |
  |    - RunAsInvoker: 100% unprivileged user mode; zero root/sudo/UAC requirement   |
  |    - Zero-Egress by default: zero telemetry, zero unverified background outbound |
  |    - Safe Process Isolation: cwd package exclusion, sanitized error messages     |
  |    - 48h Response SLA & statutory liability limitation (§ 521 BGB)               |
  +----------------------------------------------------------------------------------+
========================================================================================

3. 运维生命周期与执行序列流程

以下序列图展示了 AI Agent 通过 ServerCommander 调度操作的生命周期,包括并发 HTTP 探测、日志解析和试运行清单计算:

sequenceDiagram
    autonumber
    actor User as AI Assistant / User
    participant Host as MCP Host (Claude / Cursor)
    participant Wrapper as Node.js Wrapper
    participant Server as ServerCommander Server
    participant Handler as Operation Handler
    participant Disk as Local Disk / SQLite Sink
    participant Target as Network Endpoint

    User->>Host: "Check API health and prepare deploy manifest"
    Host->>Wrapper: JSON-RPC request (stdio)
    Wrapper->>Server: Forward request via child process
    Server->>Server: Parse parameters & validate config

    alt HTTP Health Probe
        Server->>Handler: Dispatch sc_health_check
        Handler->>Target: HTTP/HTTPS GET (async worker thread)
        Target-->>Handler: Status code + Latency response
        Handler-->>Server: Health result dictionary
    else Access Log Analysis
        Server->>Handler: Dispatch sc_logs_analyze
        Handler->>Disk: Read access.log & parse entries
        Handler->>Disk: Optional write structured JSON report
        Handler-->>Server: Aggregated log statistics
    else Deployment Staging
        Server->>Handler: Dispatch sc_deploy (dry_run=True)
        Handler->>Disk: Scan local_path & calculate SHA-256 tree
        Handler->>Disk: Optional insert record into deploy-history.db
        Handler-->>Server: Manifest digest & profile readiness
    end

    Server->>Server: Localize response messages (i18n engine)
    Server-->>Wrapper: JSON-RPC response
    Wrapper-->>Host: Formatted stdio output
    Host-->>User: Structured operations summary & next steps

4. 目标用户画像与高意向 SEO 查询

ServerCommander MCP 弥合了危险的原始 Shell 执行与不透明的托管控制面板之间的关键鸿沟。它为 AI Agent 提供安全、结构化的系统管理诊断能力。

目标用户画像
用户画像 ID目标用户画像主要挑战与痛点ServerCommander MCP 解决方案
[PERSONA-01]自主 AI Agent 工程师与工具架构师Agent 探索过程中,执行破坏性 bash 命令的风险很高采用严格非破坏性默认设置的结构化 JSON-RPC MCP 工具
[PERSONA-02]DevOps 与站点可靠性工程师(SRE)文件漂移未被检测、发布失败,以及不安全的同步操作确定性的 SHA-256 树哈希与本地试运行部署计划
[PERSONA-03]注重安全的系统管理员与安全运营(SecOps)人员凭据泄露、提升至 root 权限的风险,以及可疑的流量激增使用非特权 RunAsInvoker 执行、隔离机密信息并进行取证日志分析
[PERSONA-04]独立开发者与全栈维护人员手动健康监控繁琐,反复搜索日志耗时在 IDE 中即时执行 HTTP 健康检查,并自动分析机器人和错误
高意向搜索与 SEO 查询
  • "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"
  • "ai assistant server preflight checks"
  • "apache nginx log analysis mcp"
  • "resilient http health check mcp"
  • "sqlite deploy history mcp"

5. 与替代方案的对比矩阵

以下 10 个维度的矩阵将 ServerCommander 与常见的服务器管理方式进行对比,并直接映射到其运行时和治理不变量(从 INV-LOCAL-01 到 INV-SLA-10):

维度不变量ServerCommander MCPSSH / 原始 Bash 脚本重型 Web 面板(cPanel)云端 SaaS APM(Datadog)通用终端 MCP
1. AI 原生工具调用INV-I18N-08直接使用 stdio / JSON-RPC 架构需要脆弱的提示词胶合代码无 / 仅限 Web 浏览器自定义 API Webhook原始非结构化文本
2. 安全暂存与试运行INV-DRY-02默认 dry_run=True + SHA-256 树错误输入可能造成严重破坏Web 变更不透明只读 Agent 指标任意命令均有危险
3. 本地优先与零外发INV-LOCAL-01100% 本地运行 / 零遥测本地 / 直接远程远程主机 Web 门户持续向外发送遥测数据本地 Shell 执行
4. 权限要求INV-PRIV-06非特权 RunAsInvoker通常需要 sudo / root完全 root 权限的系统守护进程root 守护进程 / 系统 Agent继承主机 Shell 权限
5. 取证日志分析INV-LOG-03Regex 令牌解析 + 机器人审计手动使用 grep / awk / sed基础 UI 日志查看器笨重的专有 Agent原始 grep 输出
6. 弹性 HTTP 探测INV-PROBE-04非阻塞线程 + 安全批处理curl 循环(遇到首个错误即失败)定期轮询检查集中式外部探测curl CLI 子进程
7. 邮件安全暂存INV-MAIL-05检查就绪状态,但不发送邮件直接发送邮件命令有风险Webmail 界面邮件告警服务盲目调用 mailx
8. 进程与 CWD 隔离INV-SEC-07PYTHONSAFEPATH=1 防护Shell 会继承不可信的 CWD固定的守护进程用户沙箱化系统服务继承调用者环境
9. 云同步冲突防护INV-SYNC-09内置 gitignore 与锁定保护无(仅 git)仅数据库状态托管在云端的仪表板无
10. 安全 SLA 与治理INV-SLA-10通过 [email protected] 提供 48h/5d/30d SLA社区支持 / 自行维护供应商商业支持企业级商业 SLA无人维护的社区项目

6. 核心能力与安全不变量

不变量能力 / 规则实现保证技术细节
INV-LOCAL-01100% 本地优先与零外发默认采用非破坏性诊断诊断与试运行规划均在本地执行,不会未经授权向远程发送遥测数据。
INV-DRY-02故障安全的部署暂存默认 dry_run=True在接触目标之前计算 SHA-256 树摘要并验证配置文件。
INV-LOG-03经清理的访问日志分析取证式只读解析正则表达式令牌提取可检测错误、机器人和路径遍历,且不会泄露机密。
INV-PROBE-04弹性健康探测非阻塞工作线程HTTP 探测通过 asyncio.to_thread 执行;无效端点不会中止批次。
INV-MAIL-05邮件配置状态试运行安全的非执行式暂存验证 IMAP/SMTP 配置和凭据,不会意外发送邮件。
INV-PRIV-06无特权 RunAsInvoker不提升至 root/sudo 权限(不提权)完全在标准用户权限范围内运行;无需管理员权限。
INV-SEC-07安全的进程与软件包隔离防御恶意软件包启动器强制设置 PYTHONSAFEPATH=1,以防止当前工作目录中的软件包劫持。
INV-I18N-08原生 6 语言 i18n 引擎全面的多语言一致性为 en、de、es、zh、ja、ru 提供本地化工具描述、架构参数和错误信息。
INV-SYNC-09云同步冲突加固多主机 gitignore 防护加固机制可防御 OneDrive/Dropbox 同步副本(*-conflict-*)和多 Agent 锁(LOCK*)。
INV-SLA-10双语安全 SLA48 小时/5 天/30 天保证通过 [email protected] 和 [email protected],承诺在 48 小时内响应漏洞、5 天内完成分级处置,并在 30 天内完成修复。

7. 从这里开始与快速指南

目标从这里开始主要功能
将 ServerCommander 添加到 Claude Desktop、Claude Code、Cursor 或其他 MCP 主机MCP 客户端配置通过 npm 全局安装或 npx 调用,无需繁琐设置
在部署前检查公共或内部 HTTP 端点sc_health_check并发非阻塞请求、延迟计时、弹性批次错误处理
检查 Apache/Nginx 访问日志中的错误、机器人、引荐来源和可疑路径sc_logs_analyze状态码明细、字节传输总量、机器人标记、可选 JSON 报告
在通过 SFTP/SSH 执行前,构建确定性的部署试运行清单sc_deploy 和 sc_deploy_status递归 SHA-256 树哈希、符号链接绕过防护、SQLite 历史记录
为后续邮件操作做好配置,同时避免今天意外发送邮件sc_mail_list、sc_mail_read、sc_mail_send、sc_mail_search协议就绪状态验证、凭据检查、安全的 alpha 阶段暂存

8. 状态与协议支持

  • 传输:通过 Python MCP SDK 和 Node.js 进程包装器使用标准输入/输出(stdio)。
  • 软件包状态:由 ellmos-ai 组织发布的公开 alpha 软件包。
  • 当前核心功能:MCP 工具列表、工具分发、TOML 配置加载器、HTTP 健康检查、更丰富的访问日志分析(支持选择性持久化 JSON 报告),以及可选的本地试运行部署历史记录。
  • 安全的 Alpha 处理程序:sc_deploy 在试运行模式下生成本地 SHA-256 清单、配置诊断信息,以及可选择写入 SQLite 的历史记录;默认情况下,sc_mail_* 会报告特定协议的 IMAP/SMTP 就绪状态,但不会建立邮件连接。
  • i18n 本地化:为 en、de、es、zh、ja、ru 提供本地化的 MCP 工具描述、输入架构字段描述和未知工具错误,并自动回退到英语。

9. 安装与先决条件

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。如果需要隔离环境,请在该文件夹之外创建。


10. 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"
      }
    }
  }
}

11. 配置与配置文件规范

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。


12. 工具与处理程序参考

  • sc_health_check:检查 HTTP/HTTPS 端点,并报告状态码、响应头和延迟。格式错误的端点 URL 会被妥善记录为失败检查,而不会导致批量检查中止。
  • sc_logs_analyze:分析内联文本或本地文件中的 Apache/Nginx 访问日志,报告 HTTP 状态类别(2xx/3xx/4xx/5xx)、传输总字节数、最常见的引荐来源、404/500 错误路径、可疑的机器人标记,以及通过 persist_report 可选持久化的 JSON 报告。
  • sc_deploy:创建试运行部署计划,生成本地 SHA-256 清单和配置文件诊断信息,但不会执行远程更改。嵌套符号链接会记为 skipped_symlinks,以防意外遍历目录。
  • 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 客户端。

13. 搜索、消歧与发现关键词

ServerCommander 是 ellmos 的运维 MCP 服务,适用于本地优先的服务器管理工作流。搜索以下内容时,请使用此仓库:

  • MCP 服务运维工具
  • MCP 部署试运行服务
  • MCP 访问日志分析器
  • MCP HTTP 健康检查工具
  • 本地优先的服务器管理 MCP
  • Claude Code 服务器运维 MCP
  • 安全的 SFTP 部署规划 MCP
  • AI 助手服务器预检
  • Apache Nginx 日志分析 MCP
  • 弹性 HTTP 健康检查 MCP
  • SQLite 部署历史记录 MCP

它不是 GitHub MCP 服务,不是通用的任意 shell 执行 MCP 服务,不是云托管服务商控制面板,也不是未经验证的生产环境 SFTP/IMAP 自动执行器。当前 alpha 功能有意侧重诊断、优先采用试运行,并默认确保安全。


14. 同级生态系统矩阵

此 MCP 服务是 ellmos-ai 生态系统和 open-bricks 开源软件家族的重要组成部分。

MCP 服务家族
服务工具主要用途npm 软件包
FileCommander46文件系统操作、进程监控、会话、云锁处理ellmos-filecommander-mcp
CodeCommander22代码分析、AST 检查、JSON 修复、导入、差异、正则表达式ellmos-codecommander-mcp
Clatcher12文件修复、编码校正、格式转换、批处理工具ellmos-clatcher-mcp
n8n Manager18n8n 工作流管理、部署、节点探索n8n-manager-mcp
ControlCenter20MCP 技术栈发现、配置管理、控制平面路由ellmos-controlcenter-mcp
Homebase45本地优先的大模型记忆、知识库、群集编排ellmos-homebase-mcp
ServerCommander8服务器运维:健康检查、日志分析、试运行清单ellmos-servercommander-mcp
Blender Use3无头 Blender 3D 资源 QA 和自动 FBX 重新导入ellmos-blender-use-mcp
Open Compute10与模型无关的计算机操作:屏幕捕获、安全门控操作open-compute-mcp
AI 基础设施与开发者工具
项目描述
BACH面向大模型 Agent 的本地优先文本操作系统 — 113+ 个处理程序、550+ 个工具、SQLite 记忆
open-compute与模型无关的计算机操作核心,为 Open Compute MCP 提供支持
clutch与提供商无关的大模型编排,支持自动路由和预算跟踪
rinnsal轻量级 Agent 记忆、连接器和自动化基础设施
sqlite-transit-sync加密 SQLite 中转同步与增量只读副本引擎
workflowhooker由 Git 钩子驱动的工作流自动化与执行安全边界
system-explorer本地优先的系统组合、模块内省和设备群验证
companion-for-agyAntigravity 开发者助手与遥测桥接器
桌面软件套件

我们的合作组织 open-bricks 提供面向 AI 时代打造的桌面效率应用:


15. 第三方许可证与一级 SBOM

ellmos ServerCommander MCP 严格基于宽松的开源基础构建。我们不包含任何隐藏遥测、专有二进制文件或未经验证的动态依赖项。

  • 直接运行时依赖:Python MCP SDK(mcp>=1.0.0,MIT License,Anthropic PBC)、Python 标准库(PSFL-2.0)。
  • Node CLI 包装器:使用 update-notifier(BSD-2-Clause,Sindre Sorhus)进行非侵入式 CLI 更新检查。
  • 可选扩展:仅当明确安装可选的 [sftp] 扩展时,才会动态导入 paramiko(LGPL-2.1)。
  • 开发者工具:pytest(MIT)、pytest-asyncio(Apache-2.0)、ruff(MIT/Apache-2.0)、hatchling(MIT)。
  • 审计台账与一级 SBOM:完整的许可证披露、版权声明及本地优先合规保证记录在 THIRD_PARTY_LICENSES.md 和纯文本配套文件 THIRD_PARTY_LICENSES.txt 中。正式的仓库归属信息见 NOTICE。

16. 安全政策与运营限制(48 小时 SLA)

有关漏洞报告、响应 SLA 和本地优先安全不变量的详情,请参阅双语版 SECURITY.md。


17. 开发、验证与 CI 矩阵

# Set UTF-8 encoding
$env:PYTHONIOENCODING = "utf-8"

# Run complete pytest test suite
python -m pytest -v

# Run Ruff linter
ruff check .

# Verify Node CLI smoke test
npm run smoke

# Verify npm packaging (dry-run)
npm pack --dry-run

有关详细的贡献指南、Plan D 本地开发工作流和质量门禁,请参阅 CONTRIBUTING.md。


18. 法定声明、责任限制与许可(§ 521 BGB)

法定免责声明(§ 521 BGB 好意施惠)

本开源软件产品作为《德国民法典》(BGB)第 516 条及后续条款所指的无偿赠与提供。根据 § 521 BGB,作者和贡献者的责任仅限于故意行为和重大过失。此外,MIT 许可证中的下述责任免责声明同样适用。

使用风险由用户自行承担。无维护义务,不保证可用性,也不保证无错误或适用于特定用途。

英文摘要

本项目是一项无偿的开源捐赠。根据《德国民法典》(BGB)第 521 条,责任严格限于故意不当行为和重大过失的情形。下方的 MIT 许可证列有补充责任免责声明。

使用风险完全由用户自行承担。不承诺维护,不保证可用性,也不对其适用于任何特定用途作出保证。

许可证与署名

根据 MIT License 的条款分发。
版权所有 (c) 2026 Lukas Geiger。详情请参阅 LICENSE 和 NOTICE。
第三方许可证和 Level 1 SBOM 声明已在 THIRD_PARTY_LICENSES.md 中审计。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。