MCP Shell Server

🚀 MCP Shell Server

MCP Shell Server是一個安全的命令執行服務器，實現了模型上下文協議（MCP）。它允許遠程執行經過批准的shell命令，還支持通過stdin傳遞輸入，為用戶提供了安全且靈活的命令執行環境。

🚀 快速開始

啟動服務器

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

ALLOW_COMMANDS（或其別名 ALLOWED_COMMANDS）環境變量指定允許執行的命令。命令之間用逗號分隔，可選空格。

ALLOW_COMMANDS的有效格式：

ALLOW_COMMANDS="ls,cat,echo"          # 基本格式
ALLOWED_COMMANDS="ls ,echo, cat"      # 包含空格的格式

請求示例

{
  "id": "string",
  "method": "shell",
  "params": {
    "command": "string"
  }
}

✨ 主要特性

• 安全命令執行：僅允許批准的命令執行。
• 標準輸入支持：通過stdin傳遞輸入到命令。
• 全面輸出：返回stdout、stderr、退出狀態和執行時間。
• Shell操作符安全性：在shell操作符（; , &&, ||, |）之後驗證命令。
• 超時控制：設置命令的最大執行時間。

📦 安裝指南

本地版本安裝

pip install mcp-shell-server

💻 使用示例

基礎用法

# 啟動服務器並指定允許的命令
ALLOW_COMMANDS="ls,cat,echo" uvx mcp-shell-server

高級用法

# 使用別名指定允許的命令
ALLOWED_COMMANDS="ls ,echo, cat" uvx mcp-shell-server

📚 詳細文檔

MCP客戶端配置在Claude.app中

發佈版本

code ~/Library/Application\ Support/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\ Support/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"
      }
    }
  }
}

安全注意事項

• 所有命令執行都在受控環境中進行。
• 禁止危險的系統調用和文件操作。

🔧 技術細節

開發環境設置

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

📄 許可證

本項目採用MIT License，詳見LICENSE文件。