Simonb97 Win Cli MCP Server

🚀 Windows CLI 工具文檔

該工具是一個基於 Windows 的命令行接口 (CLI) 解決方案，支持命令執行、獲取命令歷史記錄以及通過 SSH 遠程執行命令等功能。下面為你詳細介紹其技術規格和使用方法。

🚀 快速開始

此 Windows CLI 工具提供了一系列實用功能，能幫助你在 Windows 系統下高效執行命令。你可以使用它在本地或通過 SSH 在遠程設備上執行命令，還能查看命令歷史記錄。

✨ 主要特性

• execute_command：可在指定的 Shell 環境中執行命令。
• get_command_history：獲取已執行的命令歷史記錄。
• ssh_execute：通過 SSH 協議在遠程設備上執行命令。
• ssh_disconnect：斷開與遠程 SSH 服務器的連接。

📚 詳細文檔

工具概覽

• execute_command：在指定的 Shell 環境中執行命令。
• get_command_history：獲取已執行的命令歷史記錄。
• ssh_execute：通過 SSH 協議在遠程設備上執行命令。
• ssh_disconnect：斷開與遠程 SSH 服務器的連接。

技術規格

execute_command

• 輸入參數：
  • shell：指定 Shell 類型（"powershell"、"cmd" 或 "gitbash"）。
  • command：需要執行的具體命令。
  • workingDir（可選）：指定工作目錄，默認為當前目錄。
• 輸出：
  • 成功執行命令：返回命令的輸出結果。
  • 執行失敗：返回錯誤信息。

get_command_history

• 輸入參數：
  • limit（可選數字）：設置獲取的歷史記錄數量上限。
• 輸出：返回包含時間戳的命令歷史記錄及其對應的輸出結果。

ssh_execute

• 輸入參數：
  • connectionId：指定要使用的 SSH 連接標識符。
  • command：在遠程設備上執行的具體命令。
• 輸出：
  • 成功執行：返回命令的輸出結果。
  • 執行失敗：返回錯誤信息。

ssh_disconnect

• 輸入參數：
  • connectionId：指定要斷開的 SSH 連接標識符。
• 輸出：返回確認消息，表明連接已成功斷開。

安全注意事項

• 命令控制：基於可執行文件名稱和完整路徑來阻止特定命令。
• 大小寫不敏感：對於如 "DEL.EXE" 或 "del.cmd" 等不同大小寫的命令進行統一處理。
• 智能路徑解析：防止通過替換路徑等方式繞過命令限制。
• 內容分析：通過分析命令內容避免誤報，例如即使 "rm" 被阻止，"warm_dir" 仍可正常執行。
• 危險參數攔截：對可能帶來風險的命令參數進行攔截。
• 注入防護：可選功能，用於防止命令注入攻擊。
• 目錄驗證：確保工作目錄在允許的路徑範圍內。
• 長度限制：默認情況下對命令長度進行限制。
• 進程終止：確保 Shell 進程能夠被正確終止。
• 輸入驗證：所有輸入均需經過驗證後才能執行。
• 環境變量和文件訪問：在受控的允許路徑內，可能需要限制對敏感目錄和環境信息的訪問。

📄 許可證

本項目採用 MIT 許可證，詳細內容請參閱 LICENSE 文件。