SuperAPI AI 工具集

mcp-linux-tools

MCP Linux Tools 是一个 MCP(模型上下文协议)服务器,为 AI 助手(如 VS Code、Claude、Cursor)提供对 Linux 服务器的受控系统管理能力。它通过白名单机制暴露一组安全操作,包括读取文件与日志、检查与管理 systemd 服务、管理 cron 任务、运行只读 MySQL 查询、执行 WP-CLI 命令以及运行沙箱 Python 代码。服务器以 systemd 服务运行,通过 HTTP 通信,所有工具返回统一响应结构 {success, data, error, meta},并受可配置的目录、服务、WordPress 站点白名单严格限制。

访问官网

工具介绍

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 等)。

具体收费、价格、平台兼容细节暂未提供。