shield_lock
JinDaGe
← Back to MCP directory
publicPublicdnsLocal runtime

swift-mcp-gui

一个通过SwiftAutoGUI控制Mac OS X的MCP服务器，提供鼠标键盘的编程控制功能。

article

README

🚀 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
  1. 安装包：
swift package experimental-install
  1. 将以下命令添加到您的 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

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client