MCP Linux Tools 是一个 MCP(Model Context Protocol)服务器,用于让 AI 助手在受严格安全约束的前提下管理 Linux 服务器、网站和数据库。
主要能力包括:
- 元数据与发现:获取服务器信息、服务白名单、允许的 WordPress 站点列表。
- 文件操作:读取文件、列出目录、查看日志头/尾、搜索日志关键词;创建目录、修改权限和所有者(仅限 /var/www 和 /opt/)。
- 系统服务:检查服务状态、重载或重启白名单内的服务(默认仅重启,可强制完整重启)。
- Python 沙箱:执行 Python 代码(无网络,8 秒超时)。
- Cron 管理:列出、添加、删除、启用/禁用 cron 任务,并可验证调度表达式。
- WordPress 操作:运行 WP-CLI、刷新缓存、列出插件和用户、查看调试日志路径。
- 数据库操作:执行只读 MySQL 查询,危险查询被阻止。
- 网络操作:ping 主机测试连通性。
- Git 操作:执行安全 Git 命令(禁用 push/force)。
- 系统命令:执行 shell 命令(需谨慎)。
使用方式: 服务器要求 Python 3.13 或更高版本、root 权限(用于 systemctl 和 crontab)、支持 systemd 的 Linux 系统。安装步骤包括克隆仓库、创建 Python 虚拟环境、编辑 config.json 配置服务器类型/IP/名称及目录、服务、WordPress 白名单等、创建沙箱目录、安装并启动 systemd 服务。之后在 Cursor MCP 配置中添加 HTTP 传输地址(默认 http://192.168.1.22:8765/mcp)。修改 config.json 后必须重启服务。
架构为模块化 MCP 设计:server.py 为入口,core/ 包含错误码、Pydantic 模型、统一响应、安全验证和子进程运行器,tools/ 按域划分工具模块。所有工具返回统一响应契约 {success, data, error, meta}。
适用场景:需要 AI 助手辅助运维 Linux 服务器、管理 WordPress 站点和数据库的开发者或运维人员,且操作范围受白名单限制。
限制:大多数工具为只读;写操作仅限特定白名单目录和服务;不允许停止/启动/启用服务、sudo/root 操作、网络访问的 Python、修改 MCP 管理范围外的系统 crontab;所有操作受白名单限制,越界将返回 Denied;服务名称因发行版而异,需查询实际白名单;错误以统一错误码返回(如 DENIED_PATH、DENIED_SERVICE、DENIED_SITE、INVALID_INPUT、COMMAND_BLOCKED、NOT_FOUND、TIMEOUT 等)。
具体收费、价格、平台兼容细节暂未提供。