ServBay MCP Server 介绍
ServBay MCP Server 是 ServBay 内置的一个基于 Model Context Protocol(MCP) 的服务器。通过它,Claude、Cursor、VS Code 等支持 MCP 的 AI 工具可以直接「看到」并「操作」你的本地 ServBay 开发环境——查询服务状态、管理网站与域名、操作数据库、签发证书、创建备份、读取日志与系统指标等,而无需你在对话与 ServBay 界面之间来回切换。
本文介绍 ServBay MCP Server 是什么、能做什么。接入方式与 AI 规则请参阅:
- 接入 AI 客户端(IDE Integration) — 把 MCP 一键接入 Claude Code / Cursor / VS Code 等
- AI 规则(AI Rule) — 让 AI 正确、安全地使用 ServBay MCP
什么是 MCP
Model Context Protocol(MCP)是一种开放协议,用于让 AI 应用以标准化的方式连接外部工具与数据源。ServBay 把自身的环境管理能力封装成一个 MCP Server,任何兼容 MCP 的 AI 客户端都能通过它调用 ServBay 的功能。
MCP Server 以本地进程(stdio 传输)方式随 ServBay 一同分发,接入时由 AI 客户端按需拉起,无需你单独安装或部署。
ServBay MCP 能做什么
ServBay MCP Server 暴露的能力覆盖了 ServBay 的核心管理面:
- 环境与订阅 — 读取环境信息、订阅 / 套餐状态、运行诊断。
- 系统信息与指标 — 读取 CPU / 内存 / 磁盘 / 网络等系统信息与实时指标(详见 系统信息与指标)。
- 服务管理 — 列出服务、查询状态,启动 / 停止 / 重启 PHP、Node.js、MySQL、MariaDB、PostgreSQL、Redis、Memcached、Mailpit、MinIO、Ollama 等。
- 服务配置与日志 — 读取 / 写入服务配置,读取服务日志。
- 网站与域名 — 列出 / 查看 / 创建 / 更新 / 删除本地网站,启用或禁用站点,管理 hosts 记录与 dnsmasq 域名。
- 端口 — 检查端口占用。
- TLS / HTTPS 证书 — 列出、签发、重新签发、删除证书。
- 数据库 — 列出数据库、创建数据库、设置 / 重置数据库密码。
- 软件包 — 列出已安装 / 可用软件包,安装 / 卸载 / 启用 / 禁用、切换版本。
- Ollama 模型 — 列出与移除本地 Ollama 模型。
- 备份 — 列出、创建、恢复、删除备份,查看备份计划。
借助这些能力,你可以直接对 AI 说「帮我启动 PHP 8.3 并新建一个站点」「给这个域名签一张证书」「看看 MySQL 的错误日志」,由 AI 通过 MCP 调用 ServBay 完成。
安全说明
- MCP Server 只在本机运行,通过 stdio 与本机 AI 客户端通信。
- 对于写入或破坏性操作(如删除网站、重置数据库密码、恢复备份),建议先让 AI 说明将要执行的更改并经你确认后再执行。
- 请勿在对话中粘贴密钥、令牌、DNS API Key、数据库密码或私钥——ServBay MCP 的设计不需要你手动提供这些敏感信息。
- 配合 AI 规则 使用,可以让 AI 更规范、安全地使用 ServBay MCP。
前提条件
- 已安装并运行 ServBay(macOS 或 Windows)。
- 拥有一个支持 MCP 的 AI 客户端(如 Claude Code、Cursor、VS Code + Copilot、Claude Desktop、Codex 等)。
下一步
总结
ServBay MCP Server 把 ServBay 的环境管理能力开放给 AI 工具,让「用自然语言管理本地开发环境」成为可能。它随 ServBay 分发、一键接入、无需额外部署,是 ServBay 面向 AI-native 开发的关键一环。
