Tumf MCP Shell Server

🚀 MCP Shell Server

一个安全的命令执行服务器，实现模型上下文协议（MCP）。它允许远程执行经过白名单允许的shell命令，还支持通过stdin传递输入，为命令执行提供了安全且灵活的解决方案。

🚀 快速开始

在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

✨ 主要特性

• 安全命令执行：仅允许白名单中的命令执行，保障系统安全。
• 标准输入支持：通过(stdin)传递输入到命令，方便灵活输入。
• 全面输出：返回(stdout)、(stderr)、退出状态码和执行时间，提供详细执行信息。
• shell操作符安全性：在shell操作符（; , &&, ||, |）后验证命令，防止恶意操作。
• 超时控制：设置命令的最大执行时间，避免长时间占用资源。

💻 使用示例

安装依赖项

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文件。