Swift MCP GUI Server

基本能力

产品定位

Swift MCP GUI Server 是一个用于程序化控制 Mac OS X 鼠标和键盘的工具，适用于自动化测试、脚本控制等场景。

核心功能

1. 鼠标移动：通过 moveMouse 工具将鼠标光标移动到指定坐标。
2. 鼠标点击：通过 mouseClick 工具在当前光标位置执行鼠标点击。
3. 键盘输入：通过 sendKeys 工具发送键盘快捷键或组合键。
4. 滚动：通过 scroll 工具在指定方向执行滚动操作。

适用场景

• 自动化测试
• 脚本控制
• 浏览器自动化
• 开发效率工具

工具列表

1. moveMouse：移动鼠标到指定坐标。
2. mouseClick：执行鼠标点击。
3. sendKeys：发送键盘输入。
4. scroll：执行滚动操作。

常见问题解答

• 安全性：该服务具有对鼠标和键盘的完全控制权，请确保仅连接受信任的 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

1. 安装：

swift package experimental-install

1. 添加到 MCP 客户端：

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

调试方式

安装完成后，可以通过 MCP 客户端调用工具进行调试。例如，调用 moveMouse 工具移动鼠标。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。