Swift MCP Gui

🚀 Swift MCP GUI 服務器

Swift MCP GUI 服務器是一個模型上下文協議（MCP）服務器，藉助它可通過 SwiftAutoGUI 對 Mac OS X 進行控制。該服務器為用戶提供了通過 MCP 客戶端以編程方式控制鼠標和鍵盤的工具。

🚀 快速開始

要求

• 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