Shell 执行 MCP 服务器

一个提供持久 shell 命令执行功能的 Model Context Protocol (MCP) 服务器，适用于 Claude 和其他与 MCP 兼容的 AI 助手。

特性

• 持久 Shell 会话：在相同会话中维护命令之间的状态
• 后台执行：以适当的进程管理方式在后台运行命令
• 跨平台支持：适用于 macOS、Linux 和 Windows，搭配合适的 shell 使用
• 超时控制：配置命令执行超时时间，防止长时间挂起
• 会话重置：如有需要，可以重置 Shell 会话

安装

# 克隆仓库
git clone https://github.com/samihalawa/mcp-server-shell-exec.git
cd mcp-server-shell-exec

# 安装依赖
npm install

# 构建服务器
npm run build

使用方法

启动服务器

npm start

配置

将服务器添加到 MCP 配置中：

{
  "servers": {
    "shell-exec-server": {
      "command": "/path/to/node",
      "args": ["/path/to/mcp-server-shell-exec/build/index.js"],
      "enabled": true,
      "port": 3006,
      "environment": {
        "NODE_PATH": "/path/to/node_modules",
        "PATH": "/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

可用工具

execute-command

在持久 Shell 会话中执行 shell 命令。

参数：

• command (string, 必填)：要执行的 shell 命令
• runInBackground (boolean, 可选)：是否在后台运行命令。默认值：false
• timeoutMs (number, 可选)：命令的超时时间（以毫秒为单位）。默认值：30000

返回：

• success (boolean)：命令是否执行成功
• output (string)：命令执行输出的结果

reset-shell

重置 Shell 会话。此操作将终止当前会话并启动一个新的会话。

参数：无

返回：

• success (boolean)：是否成功重置了 Shell 会话
• message (string)：状态信息

示例用法

1. 执行简单命令：

   execute-command(command: "ls -la")
   

2. 在后台运行长时间任务：

   execute-command(command: "sleep 60 && echo '完成'", runInBackground: true)
   

3. 使用自定义超时时间执行命令：

   execute-command(command: "find / -name '*.js'", timeoutMs: 60000)
   

4. 重置 Shell 会话：

   reset-shell()
   

工作原理

服务器使用 Node.js 的 node-pty 包创建一个伪终端，以保持命令之间的状态。这使得：

• 环境变量在命令之间持久
• 当前工作目录保持一致
• 后台进程可以继续运行
• 需要 stdin/stdout 交互的命令能够正常运行

兼容性要求

• Node.js 14+ 版本
• node-pty 包
• 与 Claude Desktop、Cursor 等 MCP 兼容的应用程序兼容

许可证

MIT