Blazickjp Shell MCP Server

🚀 🖥️ Shell MCP 服務器

🚀 Shell MCP 服務器專為 Model Context Protocol 構建，能為 AI 應用程序添加安全的 Shell 命令執行功能，讓您的應用運行更高效、更安全！

🚀 快速開始

📦 安裝指南

# 使用 pip
pip install shell-mcp-server

# 使用 uv（推薦）
uv pip install shell-mcp-server

🔌 Claude 桌面集成

將此內容添加到您的 Claude Desktop 配置中以啟用 Shell 命令執行：

{
    "mcpServers": {
        "shell-mcp-server": {
            "command": "uv",
            "args": [
                "--venv",
                ".venv",
                "python",
                "-m",
                "shell_mcp_server.server",
                "--port",
                "23456"
            ]
        }
    }
}

✨ 主要特性

• 🔒 安全執行 - 命令僅在指定目錄中運行
• 🐚 多 Shell 支持 - 支持 bash、sh、cmd、powershell
• ⏱️ 超時控制 - 自動終止長時間運行的命令
• 🌍 跨平臺 - 適用於 Unix 和 Windows 系統
• 🛡️ 安全為先 - 內置目錄和 Shell 驗證

💻 使用示例

基礎用法

# 啟動服務器
uv python -m shell_mcp_server.server --port 23456

# 發送命令
curl http://localhost:23456/shell -X POST -d "echo Hello World!"

高級用法

from shell_mcp_server import ShellMCPClient

client = ShellMCPClient("http://localhost:23456")
# 執行命令並獲取輸出
result = client.run_command("ls -a")
print(result.stdout)  # 輸出結果

📚 詳細文檔

配置

通過以下方式配置服務器：

# 啟動時指定配置文件
uv python -m shell_mcp_server.server --config config.json

config.json 示例：

{
    "port": 23456,
    "allowed_commands": ["ls", "echo"],
    "super_users": ["user1", "user2"]
}

安全特性

• 命令白名單 - 只允許指定的命令執行
• 超級用戶支持 - 允許特定用戶繞過命令限制
• 訪問控制 - 通過 IP 或其他方式限制連接

開發

設置開發環境：

# 創建並激活虛擬環境
uv venv
source .venv/bin/activate

# 安裝開發依賴
uv pip install -e ".[test]"

# 運行測試
python -m pytest

# 帶覆蓋率運行測試
python -m pytest --cov=shell_mcp_server

貢獻

歡迎貢獻！請隨意：

• 🐛 報告問題
• 💡 提建議
• 🔧 提交拉取請求
• 📚 改進文檔

📄 許可證

MIT 許可證 - 詳見 LICENSE 瞭解詳細信息。