关于 ellmos ServerCommander
ellmos ServerCommander 是面向 AI 编码助手和系统运维人员的本地优先 MCP 服务,用于日常服务器诊断。它提供 HTTP 检查、访问日志分析、邮件就绪检查和部署试运行,默认采用非破坏性操作。
主要功能
- 01HTTP 健康检查
- 02访问日志分析
- 03邮件配置就绪检查
- 04部署试运行清单
- 05SHA-256 文件树哈希
- 06本地部署历史记录
适用场景
- 01部署前检查端点
- 02从日志中查找错误或可疑流量
- 03验证邮件配置而不发送邮件
- 04传输前准备部署清单
MCP 相关
它通过 stdio 向 MCP 客户端提供服务器诊断和部署规划工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
ellmos-servercommander-mcp
用于本地优先服务器运维的 Alpha Model Context Protocol (MCP) 服务:部署试运行、邮件配置状态、访问日志分析和弹性 HTTP 健康检查。
德语版 README:README_de.md
隶属于 ellmos-ai 系列,该系列由 open-bricks 开源项目群支持。
说明
**可发现性与 AI 搜索:**已在 npm 上发布,包名为
ellmos-servercommander-mcp;已在server.json、glama.json和smithery.yaml中编入 MCP 生态目录,并通过llms.txt编入 AI/大模型搜索索引。
快速导航
- 执行摘要与核心定位
- 可视化架构与系统拓扑
- 运维生命周期与执行序列流程
- 目标用户画像与高意向 SEO 查询
- 与替代方案的对比矩阵
- 核心能力与安全不变量
- 从这里开始与快速指南
- 状态与协议支持
- 安装与先决条件
- MCP 客户端配置与部署模式
- 配置与配置档规范
- 工具与处理程序参考
- 搜索、消歧与发现关键词
- 同类生态矩阵
- 第三方许可证与一级 SBOM
- 安全策略与运行限制(48h SLA)
- 开发、验证与 CI 矩阵
- 法定声明、责任限制与许可证(§ 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 MCP | SSH / 原始 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-01 | 100% 本地运行 / 零遥测 | 本地 / 直接远程 | 远程主机 Web 门户 | 持续向外发送遥测数据 | 本地 Shell 执行 |
| 4. 权限要求 | INV-PRIV-06 | 非特权 RunAsInvoker | 通常需要 sudo / root | 完全 root 权限的系统守护进程 | root 守护进程 / 系统 Agent | 继承主机 Shell 权限 |
| 5. 取证日志分析 | INV-LOG-03 | Regex 令牌解析 + 机器人审计 | 手动使用 grep / awk / sed | 基础 UI 日志查看器 | 笨重的专有 Agent | 原始 grep 输出 |
| 6. 弹性 HTTP 探测 | INV-PROBE-04 | 非阻塞线程 + 安全批处理 | curl 循环(遇到首个错误即失败) | 定期轮询检查 | 集中式外部探测 | curl CLI 子进程 |
| 7. 邮件安全暂存 | INV-MAIL-05 | 检查就绪状态,但不发送邮件 | 直接发送邮件命令有风险 | Webmail 界面 | 邮件告警服务 | 盲目调用 mailx |
| 8. 进程与 CWD 隔离 | INV-SEC-07 | PYTHONSAFEPATH=1 防护 | Shell 会继承不可信的 CWD | 固定的守护进程用户 | 沙箱化系统服务 | 继承调用者环境 |
| 9. 云同步冲突防护 | INV-SYNC-09 | 内置 gitignore 与锁定保护 | 无(仅 git) | 仅数据库状态 | 托管在云端的仪表板 | 无 |
| 10. 安全 SLA 与治理 | INV-SLA-10 | 通过 [email protected] 提供 48h/5d/30d SLA | 社区支持 / 自行维护 | 供应商商业支持 | 企业级商业 SLA | 无人维护的社区项目 |
6. 核心能力与安全不变量
| 不变量 | 能力 / 规则 | 实现保证 | 技术细节 |
|---|---|---|---|
| INV-LOCAL-01 | 100% 本地优先与零外发 | 默认采用非破坏性诊断 | 诊断与试运行规划均在本地执行,不会未经授权向远程发送遥测数据。 |
| 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 | 双语安全 SLA | 48 小时/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 按以下优先级顺序查找配置文件:
- 环境变量
SERVERCOMMANDER_CONFIG_PATH ./servercommander.toml./config/servercommander.toml~/.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 软件包 |
|---|---|---|---|
| FileCommander | 46 | 文件系统操作、进程监控、会话、云锁处理 | ellmos-filecommander-mcp |
| CodeCommander | 22 | 代码分析、AST 检查、JSON 修复、导入、差异、正则表达式 | ellmos-codecommander-mcp |
| Clatcher | 12 | 文件修复、编码校正、格式转换、批处理工具 | ellmos-clatcher-mcp |
| n8n Manager | 18 | n8n 工作流管理、部署、节点探索 | n8n-manager-mcp |
| ControlCenter | 20 | MCP 技术栈发现、配置管理、控制平面路由 | ellmos-controlcenter-mcp |
| Homebase | 45 | 本地优先的大模型记忆、知识库、群集编排 | ellmos-homebase-mcp |
| ServerCommander | 8 | 服务器运维:健康检查、日志分析、试运行清单 | ellmos-servercommander-mcp |
| Blender Use | 3 | 无头 Blender 3D 资源 QA 和自动 FBX 重新导入 | ellmos-blender-use-mcp |
| Open Compute | 10 | 与模型无关的计算机操作:屏幕捕获、安全门控操作 | 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-agy | Antigravity 开发者助手与遥测桥接器 |
桌面软件套件
我们的合作组织 open-bricks 提供面向 AI 时代打造的桌面效率应用:
- 文件管理:ProFiler、ExplorerPro、CloudLockFixer
- 文档处理:DokuZen、PDFtoPDFocr、FormularErstellen
- 开发者工具:DevCenter、CodeBox、automizer-for-claude-desktop
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。
- 漏洞报告:GitHub 安全公告或发送邮件至
[email protected]/[email protected]。 - 响应 SLA:48 小时内完成初步分诊;5 个工作日内更新状态。
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 中审计。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。