Shell MCP 服务器

一个 Node.js 实现的 Model Context Protocol (MCP)，提供安全的 shell 命令执行能力。该服务器允许 AI 模型在受控环境中执行 shell 命令，并具有内置的安全措施。可以轻松与 Claude Desktop 集成，以将 Claude 与您的 shell 连接。

功能

• 符合 MCP 协议的服务器实现
• 具有黑名单保护的安全命令执行
• 命令存在性验证
• 基于标准 I/O 的传输
• 错误处理和优雅关闭

安装

运行 npx mcp-shell。

要将其添加到 Claude Desktop，请运行 npx mcp-shell config。或者手动将 npx -y mcp-shell 添加到您的配置中。

启动（或重启）Claude Desktop，您应该会在登陆页面上看到 MCP 工具。

安全功能

该服务器实现了以下安全措施：

1. 命令黑名单

   • 阻止执行危险的系统命令
   • 阻止访问关键系统修改
   • 防止文件系统损坏
   • 防止权限提升

2. 命令验证

   • 在执行前验证命令是否存在
   • 根据黑名单进行验证
   • 为无效命令返回清晰的错误消息

可用工具

该服务器提供一个工具：

run_command

执行一个 shell 命令并返回其输出。

输入 Schema:

{
  "type": "object",
  "properties": {
    "command": { "type": "string" }
  }
}

响应:

• 成功：命令输出为纯文本
• 错误：错误消息为纯文本

黑名单命令

以下命令类别因安全原因而被阻止：

• 文件系统破坏命令 (rm, rmdir, del)
• 磁盘/文件系统命令 (format, mkfs, dd)
• 权限/所有权命令 (chmod, chown)
• 权限提升命令 (sudo, su)
• 代码执行命令 (exec, eval)
• 系统通信命令 (write, wall)
• 系统控制命令 (shutdown, reboot, init)

错误处理

该服务器包括全面的错误处理：

• 命令未找到错误
• 黑名单命令错误
• 执行错误
• MCP 协议错误
• SIGINT 上的优雅关闭

实现细节

该服务器使用以下技术构建：

• Model Context Protocol SDK
• 用于通信的 StdioServerTransport
• 用于命令执行的 execa
• 用于命令验证的 command-exists

开发

要修改安全设置，您可以：

1. 编辑 BLACKLISTED_COMMANDS 集合以调整阻止的命令
2. 修改 validateCommand 函数以添加其他验证规则
3. 增强 CallToolRequestSchema 处理程序中的命令解析逻辑