Swiftautogui

🚀 Swift MCP GUI 服務器

Swift MCP GUI 服務器是一個模型上下文協議（MCP）服務器，它藉助 SwiftAutoGUI 實現對 Mac OS X 的控制。該服務器為 MCP 客戶端提供了控制 macOS 鼠標和鍵盤的工具，極大地方便了相關操作。

🚀 快速開始

在使用 Swift MCP GUI 服務器之前，需要滿足一定的要求並完成安裝步驟。

✨ 主要特性

• 支持通過 MCP 客戶端控制 macOS 的鼠標和鍵盤。
• 提供了多種實用工具，如鼠標移動、點擊、鍵盤輸入和滾動等。

📦 安裝指南

環境要求

• macOS 15.0 或更高版本
• Swift 6.0 或更高版本
• Xcode 16.0 或更高版本

安裝步驟

1. 克隆此倉庫：

git clone https://github.com/NakaokaRei/swift-mcp-gui.git
cd swift-mcp-gui

2. 安裝

swift package experimental-install

3. 將命令添加到您的 MCP 客戶端。

{
  "mcpServers" : {
    "swift-mcp-gui" : {
      "command" : "/Users/USERNAME/.swiftpm/bin/swift-mcp-gui"
    }
  }
}

💻 使用示例

基礎用法

服務器提供了以下工具，用於控制 macOS：

1. 鼠標移動

• 工具名稱：moveMouse
• 輸入：
  • x: Double（x 座標）
  • y: Double（y 座標）
• 功能：將鼠標指針移動到指定的座標

2. 鼠標點擊

• 工具名稱：mouseClick
• 輸入：
  • button: String（"left" 或 "right"）
• 功能：在當前光標位置執行鼠標單擊

3. 鍵盤輸入

• 工具名稱：sendKeys
• 輸入：
  • keys: String 數組（鍵名）
• 功能：發送鍵盤快捷鍵或鍵組合
• 示例鍵： "command", "control", "option", "shift", "return", "space", "a", "1" 等

4. 滾動

• 工具名稱：scroll
• 輸入：
  • direction: String（"up", "down", "left", "right"）
  • clicks: Int（滾動次數）
• 功能：在指定方向執行滾動操作

📚 詳細文檔

安全注意事項

⚠️ 重要提示

此服務器對您的鼠標和鍵盤有完全控制權。請謹慎運行，並僅連接受信任的 MCP 客戶端。

📄 許可證

本項目採用 MIT License 進行許可。