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