Shell Command MCP Server

基于Docker的隔离Shell命令执行MCP工具

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Shell Command MCP Server。
它的用途是:基于Docker的隔离Shell命令执行MCP工具
完整的 Skill 内容见:https://321skill.com/skills/shell-command-mcp-server/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请在安全环境中执行 `df -h` 查看磁盘使用情况',它会调用Shell Command MCP Server在Docker容器中执行该命令,返回容器内的磁盘信息。你还可以说:'帮我运行 `npm run build`,使用 Node 18 镜像',工具会自动拉取指定镜像并执行构建,输出构建日志。如果命令执行失败,AI会返回错误码和错误信息,方便你快速定位问题。

介绍

在开发与运维工作中,经常需要让AI助手直接执行系统命令来管理文件、查看日志、运行脚本或部署服务。然而,直接暴露Shell给AI存在严重的安全风险——恶意命令可能破坏主机环境、泄露敏感数据。这个MCP服务器通过将每条命令封装在独立的Docker容器中执行,彻底隔离了AI对主机的直接影响,让你在享受自动化便利的同时,守住安全底线。

使用方法非常简单:完成安装后,在支持MCP协议的客户端(如Claude、Cursor等)中配置该服务器的地址,即可在对话中直接向AI下达Shell命令。AI会自动将命令发送到Docker容器中执行,并返回标准输出和错误信息。你可以指定容器镜像、资源限制、超时时间等参数,满足不同场景下的隔离与性能要求。

适合运维工程师、后端开发、全栈开发以及任何需要在安全可控环境中执行系统命令的用户。例如,运维人员可以放心让AI批量检查服务器状态、执行备份脚本;后端开发可以在测试环境中快速验证构建命令、运行自动化测试,无需担心影响本地开发环境。

建议在配置时明确指定Docker镜像和资源限制,避免容器占用过多宿主机资源。注意,该工具本身不管理容器生命周期,每次执行都会创建新容器,频繁调用可能产生较多容器残留,建议定期清理。另外,如果你需要持久化文件系统或跨命令共享状态,需要额外挂载卷或使用持久化容器方案。

核心特点

与直接执行Shell命令的MCP工具不同,该工具强制在Docker容器中运行每条命令,提供真正的进程隔离和文件系统隔离,避免AI误操作或恶意命令影响宿主机,同时支持自定义镜像,可预装所需工具链。

注意事项

不适合需要高频执行超短命令(如简单Ping)的场景,因为每次启动新容器有额外开销;也不适合需要在命令间共享文件系统状态(如连续编译)的场景,除非额外配置持久化卷。

常见问题

如何安装Shell Command MCP Server?

运行 `npm install -g shell-command-mcp-server` 进行全局安装,然后在MCP客户端配置中指向该服务器。需要确保宿主机已安装Docker并正常运行。

是否支持Windows系统?

支持,但需确保Docker Desktop for Windows已安装并配置为Linux容器模式。命令执行环境为容器内的Linux系统,宿主Windows不影响使用。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/shell-command-mcp-server/raw/index.md 读取 Shell Command MCP Server 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。