Shell Execution MCP Server

基本能力

产品定位

Shell Execution MCP Server 是一个专为AI助手设计的shell命令执行服务，旨在通过MCP协议提供持久化的shell命令执行环境。

核心功能

• 持久Shell会话：在同一个会话中保持命令之间的状态。
• 后台执行：支持在后台运行命令，并进行适当的进程管理。
• 跨平台兼容：适用于macOS、Linux和Windows系统。
• 超时控制：可配置命令执行超时，防止挂起。
• 会话重置：支持重置shell会话。

适用场景

• 需要持久化shell环境的AI助手交互。
• 需要后台执行长时间运行命令的场景。
• 跨平台shell命令执行需求。

工具列表

• execute-command：在持久shell会话中执行命令。
• 参数：command（必需）、runInBackground（可选）、timeoutMs（可选）。
• 返回：success、output。
• reset-shell：重置shell会话。
• 参数：无。
• 返回：success、message。

常见问题解答

• 依赖要求：需要Node.js 14+和node-pty包。
• 兼容性：兼容Claude Desktop、Cursor和其他MCP兼容应用。

使用教程

使用依赖

确保已安装Node.js 14+和node-pty包。

安装教程

# 克隆仓库
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"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款。