Cli MCP Server

🚀 CLI MCP 服務器

本項目是一個安全的模型上下文協議（MCP）服務器實現，專為通過模型上下文協議進行交互設計，可在具備全面安全功能的環境下執行命令。

🚀 快速開始

依賴項安裝

使用以下命令安裝項目依賴項：

pip install -r requirements.txt

啟動服務器

要啟動 MCP 服務器，請運行：

python cli_mcp_server.py

✨ 主要特性

• 命令白名單：允許指定可執行的命令及其支持的標誌。
• 標誌驗證：確保使用的標誌符合預期。
• 路徑遍歷預防：防止通過相對路徑或符號鏈接進行惡意操作。
• shell 操作符阻止：禁止使用危險的 shell 操作符，如 ;、& 等。
• 命令長度限制：防止過長的命令導致的安全風險。
• 執行超時：設置命令的最大允許執行時間，防止長時間未響應的命令。
• 工作目錄限制：將命令限制在指定的工作目錄內，防止越界訪問。

📦 安裝指南

服務器可以通過以下環境變量進行配置：

💻 使用示例

可用工具

1. run_command

用於在受控環境中執行命令。支持以下操作：

• 執行允許的命令。
• 驗證標誌的有效性。
• 確保路徑的安全性。

輸入格式

{
  "command": "echo",
  "args": ["hello", "world"],
  "flags": ["-n"]
}

2. show_security_rules

顯示當前服務器的安全策略配置，包括允許的命令、標誌和工作目錄限制。

與 Claude 桌面的使用

在 Claude 桌面環境中集成此服務器時，請按照以下步驟進行配置：

開發模式

{
  "mcpServers": {
    "cli-mcp-server": {
      "command": "uv",
      "args": ["run", "cli-mcp-server"],
      "env": {
        "ALLOWED_COMMANDS": "echo,ls,-h",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30"
      }
    }
  }
}

發佈模式

{
  "mcpServers": {
    "cli-mcp-server": {
      "command": "uvx",
      "args": ["cli-mcp-server"],
      "env": {
        "ALLOWED_COMMANDS": "echo,ls,-h",
        "ALLOWED_FLAGS": "-l,-a,--help,--version",
        "MAX_COMMAND_LENGTH": "1024",
        "COMMAND_TIMEOUT": "30"
      }
    }
  }
}

📚 詳細文檔

簡介

此 CLI MCP 服務器旨在通過模型上下文協議提供一個安全且功能豐富的命令執行環境。它支持命令白名單、標誌驗證、路徑遍歷預防等功能，確保在受控環境中運行命令。

錯誤處理

服務器提供詳細的錯誤消息以處理以下情況：

• 安全違規（CommandSecurityError）
• 命令超時（CommandTimeoutError）
• 無效命令格式
• 路徑安全違規
• 執行失敗

錯誤信息將通過標準輸出或環境變量進行報告。

開發

此文檔詳細介紹瞭如何配置和使用 MCP 服務器。如需更多信息，請參考源代碼或聯繫開發團隊。