mcp-server-macos-use
2025.04.16
47
SwiftmacOS 控制无障碍 API自动化工具浏览器自动化开发效率
mcp-server-macos-use 是一个基于 Swift 的 Model Context Protocol (MCP) 服务器，主要用于通过 macOS 的无障碍 API 控制应用程序。它通过标准输入/输出（stdio）监听 MCP 命令，并提供了多种工具来与应用程序交互。该服务器适用于 Claude Desktop 或其他兼容的 MCP 客户端。
View on GitHub
Overview
基本能力
产品定位
mcp-server-macos-use 是一个用于控制和自动化 macOS 应用程序的工具，特别适用于需要通过程序化方式与应用程序交互的场景。
核心功能
- 打开应用程序并遍历无障碍树：通过应用程序的名称、Bundle ID 或文件路径打开或激活应用程序，并遍历其无障碍树。
- 模拟鼠标点击并遍历无障碍树：在指定坐标模拟鼠标点击，并遍历目标应用程序的无障碍树。
- 模拟键盘输入并遍历无障碍树：在目标应用程序中模拟输入文本，并遍历其无障碍树。
- 模拟按键并遍历无障碍树：模拟按下特定键盘键（可带修饰键），并遍历目标应用程序的无障碍树。
- 刷新无障碍树遍历：仅遍历指定应用程序的无障碍树，不执行其他操作。
适用场景
- 自动化测试：自动化测试 macOS 应用程序的 UI 交互。
- 辅助功能开发：开发辅助功能工具，帮助残障人士使用应用程序。
- 流程自动化：自动化重复的 macOS 应用程序操作流程。
工具列表
- macos-use_open_application_and_traverse：打开或激活应用程序并遍历其无障碍树。
- macos-use_click_and_traverse：模拟鼠标点击并遍历无障碍树。
- macos-use_type_and_traverse：模拟键盘输入并遍历无障碍树。
- macos-use_press_key_and_traverse：模拟按键并遍历无障碍树。
- macos-use_refresh_traversal：仅遍历无障碍树。
常见问题解答
- 如何配置客户端？：在客户端配置文件中指定服务器可执行文件的路径。
- 如何联系开发者？：通过邮件 [email protected] 或 Discord m13v_ 联系开发者。
使用教程
使用依赖
MacosUseSDK（假设是本地或外部的 Swift 包，提供 macOS 控制功能）
安装教程
# 示例构建命令（根据需要调整，开发时使用 'debug'）
swift build -c debug # 或 'release' 用于生产环境
# 运行服务器（通过 stdin/stdout 通信）
./.build/debug/mcp-server-macos-use
调试方式
- 构建调试版本：使用
swift build -c debug构建调试版本。 - 运行服务器：运行
./.build/debug/mcp-server-macos-use启动服务器。 - 检查日志：查看服务器输出以调试问题。
客户端集成示例（Claude Desktop）
在客户端配置文件中添加以下内容：
{
"mcpServers": {
"mcp-server-macos-use": {
"command": "/path/to/your/project/mcp-server-macos-use/.build/debug/mcp-server-macos-use"
}
}
}
将 /path/to/your/project/ 替换为实际的绝对路径。