🚀 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 进行许可。