server-ops-mcp 是一个通用型服务器运维 MCP Server。它让 Claude Code / Cursor / Codex 等 AI 工具通过 .mcp.json 配置来管理多个项目或服务器，覆盖日志排查、系统资源检查、代码读写、Nginx 与证书管理等操作。
主要能力
日志排查：列出 / 读取 / 搜索项目日志、多通道日志及系统日志。 资源监控：CPU / 内存 / 磁盘 / 负载 / 进程 / 服务状态一览。 代码操作：读取、写入、打补丁、删除和搜索文件，全部沙箱限定在项目根目录内。 Nginx 与证书：配置测试与读取、安全重载、证书安装与续期。 安全设计：写操作两步确认、命令白名单、路径穿越防护、自动脱敏。
使用方式
需要 Node.js 18+。无需克隆或构建——首次使用时 npx 会自动获取并运行已发布的 npm 包。若要从源码构建（例如开发用途），构建输出位于 dist/，入口点是 dist/index.js。 在每个要使用本工具的项目中创建（或追加）.mcp.json，按环境声明 MCP Server。本地模式只需 OPS_PROJECT_ROOT；远程模式需额外添加 SSH 变量。若从源码构建，把命令指向本地构建："command": "node"，"args": ["/absolute/path/to/server-ops-mcp/dist/index.js"]。 配置完成后，在 AI 工具中用自然语言下达运维指令，AI 会自动挑选并调用合适的工具。
只读操作（直接运行）
写操作（需要确认）：对于写入、删除、命令执行、Nginx 重载、证书安装等，工具会先返回一个 confirmationId。AI 会向你展示将要执行的确切内容，只有在你确认后才真正执行。file_write、file_patch、file_delete、command_exec 等均遵循同样的确认流程。
典型场景
生产故障排查：“为什么服务器内存满了？”→ memory_analysis 与 log_search 协同工作。 例行巡检：“磁盘是不是快满了？哪个目录占用最多？”→ disk_analysis。 安全审计：“审计项目配置是否泄露密钥”→ config_audit（输出自动脱敏）。
限制与安全约束
只读工具可直接运行。 写入、命令执行、Nginx 重载、证书安装需要两步确认（confirm_execute）。 命令执行使用白名单——rm -rf、sudo、管道到 shell 等危险操作会被拒绝。 文件操作被沙箱限定在 OPS_PROJECT_ROOT 内，路径穿越会被阻止。 .env 文件和日志中的密码、令牌等敏感信息会自动脱敏。
自定义配置
下载 config.example.json 作为 config.json，然后将 OPS_CONFIG_PATH 指向它，即可自定义日志通道、命令白名单、读取上限等。config.example.json 主要字段包括：
logChannels：通道名 → 日志目录路径（相对项目根目录） maxReadLines / maxReadBytes：每次读取的行数 / 字节上限 commandWhitelist.direct：可直接运行的命令 commandWhitelist.confirm：需要确认的命令
远程操作建议
远程操作依赖 SSH——建议为 AI 使用只读账号或范围严格受限的命令白名单。 私钥文件权限应为 600（chmod 600 ~/.ssh/id_rsa）。 切勿将包含密码的 .mcp.json 或 config.json 提交到代码仓库。
许可证为 MIT © 2026 server-ops-mcp。中文文档见 README.zh-CN.md。
