Command Security Layer

🚀 MCP 命令服務器

MCP 命令服務器是一個安全的模型上下文協議（MCP）服務器，可藉助像 Claude 這類大型語言模型應用來執行系統命令，保障命令執行的安全性與可控性。

🚀 快速開始

安裝軟件包

uv pip install mcp-command-server

配置允許的命令

export ALLOWED_COMMANDS="ls,pwd,echo"

添加到 Claude Desktop 配置中

{
  "mcpServers": {
    "command-server": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_command_server"],
      "env": {
        "ALLOWED_COMMANDS": "ls,pwd,echo"
      }
    }
  }
}

✨ 主要特性

• 🔒 帶有白名單的安全命令執行，確保只有指定命令可被執行。
• ✅ 所有命令的用戶確認，增強操作的可控性。
• 📝 全面審計日誌記錄，便於後續追溯與審查。
• 🔍 輸入驗證和清理，防止惡意輸入。
• 🤖 Claude Desktop 集成，方便與 Claude 協同工作。

📚 詳細文檔

有關完整文檔，請查看docs/目錄：

• 安裝指南
• 安全指南
• API 參考
• 使用示例
• 故障排除

🔧 技術細節

設置

# 克隆倉庫
git clone https://github.com/yourusername/mcp-command-server.git
cd mcp-command-server

# 創建虛擬環境
uv venv
source .venv/bin/activate  # 在Unix/macOS上
.venv\Scripts\activate     # 在Windows上

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

測試

# 運行所有測試
pytest

# 運行特定的測試文件
pytest tests/unit/security/test_validator.py

# 帶覆蓋率運行
pytest --cov=mcp_command_server

貢獻

1. 叉克隆倉庫
2. 創建功能分支
3. 運行測試和代碼檢查
4. 提交拉取請求

📄 許可證

本項目採用 MIT 許可證，詳情請見LICENSE。