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：字符串数组（键名）
• 发送键盘快捷键或组合键
• 示例键："command"、"control"、"option"、"shift"、"return"、"space"、"a"、"1" 等。

4. 滚动

• 工具名称：scroll
• 输入：
  • direction：String ("up"、"down"、"left"、"right")
  • clicks：Integer（滚动点击次数）
• 在指定方向执行滚动

安全注意事项

此服务器完全控制您的鼠标和键盘。 运行它时请小心，并且只连接受信任的 MCP 客户端。

许可证

MIT 许可证