mcp-server-macos-use - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

mcp-server-macos-use 是一个用于控制和自动化 macOS 应用程序的工具，特别适用于需要通过程序化方式与应用程序交互的场景。

核心功能

1. 打开应用程序并遍历无障碍树：通过应用程序的名称、Bundle ID 或文件路径打开或激活应用程序，并遍历其无障碍树。
2. 模拟鼠标点击并遍历无障碍树：在指定坐标模拟鼠标点击，并遍历目标应用程序的无障碍树。
3. 模拟键盘输入并遍历无障碍树：在目标应用程序中模拟输入文本，并遍历其无障碍树。
4. 模拟按键并遍历无障碍树：模拟按下特定键盘键（可带修饰键），并遍历目标应用程序的无障碍树。
5. 刷新无障碍树遍历：仅遍历指定应用程序的无障碍树，不执行其他操作。

适用场景

1. 自动化测试：自动化测试 macOS 应用程序的 UI 交互。
2. 辅助功能开发：开发辅助功能工具，帮助残障人士使用应用程序。
3. 流程自动化：自动化重复的 macOS 应用程序操作流程。

工具列表

1. macos-use_open_application_and_traverse：打开或激活应用程序并遍历其无障碍树。
2. macos-use_click_and_traverse：模拟鼠标点击并遍历无障碍树。
3. macos-use_type_and_traverse：模拟键盘输入并遍历无障碍树。
4. macos-use_press_key_and_traverse：模拟按键并遍历无障碍树。
5. macos-use_refresh_traversal：仅遍历无障碍树。

常见问题解答

1. 如何配置客户端？：在客户端配置文件中指定服务器可执行文件的路径。
2. 如何联系开发者？：通过邮件 matt@mediar.ai 或 Discord m13v_ 联系开发者。

使用教程

使用依赖

• MacosUseSDK（假设是本地或外部的 Swift 包，提供 macOS 控制功能）

安装教程

```bash

示例构建命令（根据需要调整，开发时使用 'debug'）

swift build -c debug # 或 'release' 用于生产环境

运行服务器（通过 stdin/stdout 通信）

./.build/debug/mcp-server-macos-use
```

调试方式

1. 构建调试版本：使用 swift build -c debug 构建调试版本。
2. 运行服务器：运行 ./.build/debug/mcp-server-macos-use 启动服务器。
3. 检查日志：查看服务器输出以调试问题。

客户端集成示例（Claude Desktop）

在客户端配置文件中添加以下内容：

json
{
"mcpServers": {
"mcp-server-macos-use": {
"command": "/path/to/your/project/mcp-server-macos-use/.build/debug/mcp-server-macos-use"
}
}
}

将 /path/to/your/project/ 替换为实际的绝对路径。