Tumf MCP Shell Server

🚀 MCP Shell Server

MCP Shell Server 是一个安全的命令执行服务器，它实现了模型上下文协议（MCP）。该服务器允许远程执行经过白名单允许的 shell 命令，并支持通过 stdin 传递输入，为用户提供了安全且便捷的命令执行环境。

🚀 快速开始

安装依赖项

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

发送请求

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

✨ 主要特性

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

📦 安装指南

发布版本

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

💻 使用示例

基础用法

# 安装依赖项
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 文件。