基本能力
产品定位
Swift MCP GUI Server 是一个用于程序化控制 Mac OS X 鼠标和键盘的工具,适用于自动化测试、脚本控制等场景。
核心功能
- 鼠标移动:通过
moveMouse
工具将鼠标光标移动到指定坐标。 - 鼠标点击:通过
mouseClick
工具在当前光标位置执行鼠标点击。 - 键盘输入:通过
sendKeys
工具发送键盘快捷键或组合键。 - 滚动:通过
scroll
工具在指定方向执行滚动操作。
适用场景
- 自动化测试
- 脚本控制
- 浏览器自动化
- 开发效率工具
工具列表
- moveMouse:移动鼠标到指定坐标。
- mouseClick:执行鼠标点击。
- sendKeys:发送键盘输入。
- scroll:执行滚动操作。
常见问题解答
- 安全性:该服务具有对鼠标和键盘的完全控制权,请确保仅连接受信任的 MCP 客户端。
使用教程
使用依赖
- macOS 15.0 或更高版本
- Swift 6.0 或更高版本
- Xcode 16.0 或更高版本
安装教程
- 克隆仓库:
bash
git clone https://github.com/NakaokaRei/swift-mcp-gui.git
cd swift-mcp-gui - 安装:
bash
swift package experimental-install - 添加到 MCP 客户端:
json
{
"mcpServers" : {
"swift-mcp-gui" : {
"command" : "/Users/USERNAME/.swiftpm/bin/swift-mcp-gui"
}
}
}
调试方式
安装完成后,可以通过 MCP 客户端调用工具进行调试。例如,调用 moveMouse
工具移动鼠标。