MCP Shell Server

一个安全的命令执行服务器，实现模型上下文协议（MCP）。该服务器允许远程执行经过白名单允许的shell命令，并支持通过stdin传递输入。

功能

• 安全命令执行：仅允许白名单中的命令执行
• 标准输入支持：通过(stdin)传递输入到命令
• 全面输出：返回(stdout)、(stderr)、退出状态码和执行时间
• shell操作符安全性：在shell操作符（; , &&, ||, |）后验证命令
• 超时控制：设置命令的最大执行时间

在Claude.app中配置MCP客户端

发布版本

code ~/Library/Application\ 支持/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shell": {
      "command": "uvx",
      "args": [
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    },
  }
}

本地版本

配置

code ~/Library/Application\ 支持/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shell": {
      "command": "uv",
      "args": [
        "--directory",
        ".",
        "run",
        "mcp-shell-server"
      ],
      "env": {
        "ALLOW_COMMANDS": "ls,cat,pwd,grep,wc,touch,find"
      }
    },
  }
}

安装

pip install mcp-shell-server

使用方法

启动服务器

ALLOW_COMMANDS="ls,cat,echo" uvx mcp-shell-server
# 或使用别名
ALLOWED_COMMANDS="ls ,echo, cat" uvx mcp-shell-server

环境变量ALLOW_COMMANDS（或其别名ALLOWED_COMMANDS）指定允许执行的命令。命令之间用逗号分隔，可带空格。

支持的ALLOW_COMMANDS格式：

• ls
• cat
• echo

示例

安装依赖项

pip install mcp-shell-server

启动服务器

mcp-shell-server start --port 8000

发送请求

curl -X POST http://localhost:8000/execute \
  -H "Content-Type: application/json" \
  -d '{"command": "ls", "args": ["-a"]}'

安全措施

• 所有命令执行都在沙箱中进行
• 禁止危险操作（如修改文件系统）
• 限制资源使用

要求

• Python 3.11或更高版本
• mcp>=1.1.0

许可证

MIT License - 详情请参阅LICENSE文件