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：

鼠标移动

• 工具名称：moveMouse
• 输入参数：
  • x: Double（x 坐标）
  • y: Double（y 坐标）
• 功能：将鼠标光标移动到指定的坐标位置。

鼠标点击

• 工具名称：mouseClick
• 输入参数：
  • button: String（"left" 或 "right" 表示左键或右键）
• 功能：在当前光标位置执行鼠标点击操作。

键盘输入

• 工具名称：sendKeys
• 输入参数：
  • keys: String 数组（表示键盘按键的字符串）
• 功能：发送键盘快捷键或组合键。
• 示例按键： "command", "control", "option", "shift", "return", "space", "a", "1" 等。

滚动操作

• 工具名称：scroll
• 输入参数：
  • direction: String（"up", "down", "left", "right" 表示滚动方向）
  • clicks: Int（表示滚动的点击次数）
• 功能：在指定的方向上执行滚动操作。

⚠️ 安全注意事项

此服务器对您的鼠标和键盘拥有完全控制权。请谨慎运行，并且只连接可信赖的 MCP 客户端。

📄 许可证

MIT License