STARWARCLOUD STARWAR.AI
返回市场
远程macos使用mcp服务器

远程macos使用mcp服务器

作者：baryhuang382 星标更新：2025-06-10
安装使用来源：spider==github.com

项目介绍

MCP服务器 - 远程macOS使用

首个开源的MCP服务器，使AI能够完全控制远程macOS系统。

作为OpenAI操作员的直接替代方案，特别优化用于具有完整桌面功能的自主AI代理，无需安装任何额外软件。

Docker拉取次数 许可证：MIT

展示

  • 研究Twitter并发布Twitter(https://www.youtube.com/watch?v=--QHz2jcvcs)

    <img width="400" alt="image" src="https://gips1.baidu.com/it/u=45882439,1011316150&fm=3081&app=3081&f=PNG?w=2518&h=1428" />

  • 使用CapCut创建短视频(https://www.youtube.com/watch?v=RKAqiNoU8ec)

    <img width="400" alt="image" src="https://gips2.baidu.com/it/u=3055902036,1167364007&fm=3081&app=3081&f=PNG?w=2460&h=1370" />

  • AI招聘专员：自动收集候选人信息，筛选申请，并通过邮件应用发送面试邀请

  • AI市场实习生：LinkedIn互动 - 自动关注、点赞和评论相关用户

  • AI市场实习生：Twitter互动 - 自动关注、点赞和评论相关用户

待办事项（优先级排序）

  1. 性能优化 - 达到Ubuntu桌面替代品的速度
  2. Apple脚本生成 - 减少执行时间同时保持灵活性
  3. VNC光标可见性 - 改善调试和演示体验

我们欢迎贡献！

特点

  • 无额外API费用：免费屏幕处理，使用现有的Claude Pro计划
  • 最小设置：只需在目标Mac上启用屏幕共享 - 不需要额外的软件
  • 通用兼容性：适用于所有macOS版本，当前和未来

我们为什么构建这个

原生macOS体验无妥协

macOS原生生态系统在用户体验方面至今无人能及，并将在未来多年内继续保持黄金标准。这是人类能力真正繁荣的地方，现在你的AI可以在这种环境中流畅运行。

开放架构设计

  • 通用LLM兼容性：与您选择的任何MCP客户端配合工作
  • 模型灵活性：无缝集成OpenAI、Anthropic或其他任何LLM提供商
  • 面向未来的集成：设计以适应MCP生态系统的发展

轻松部署

  • 目标机器零设置：macOS上不需要后台应用程序或代理
  • 仅需屏幕共享：控制任何启用了屏幕共享的Mac
  • 消除后端复杂性：与其他需要运行Python应用程序或后台服务的解决方案不同

简化的引导过程

  • 利用Claude Desktop的精美UI：无需开发者风格的Python界面
  • 直观的用户体验：通过熟悉的用户友好界面与您的AI控制的Mac交互
  • 即时生产力：立即开始工作，无需配置麻烦

架构

<img width="912" alt="remote_macos_use_system_architecture" src="https://gips2.baidu.com/it/u=1940865160,2606716939&fm=3081&app=3081&f=PNG?w=1824&h=988" />

安装

{
  "mcpServers": {
    "remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME=your_macos_username",
        "-e",
        "MACOS_PASSWORD=your_macos_password",
        "-e",
        "MACOS_HOST=your_macos_hostname_or_ip",
        "-e",
        "LIVEKIT_API_KEY=your_livekit_api_key",
        "-e",
        "LIVEKIT_API_SECRET=your_livekit_api_secret",
        "-e",
        "LIVEKIT_HOST=your_livekit_host",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ]
    }
  }
}

通过LiveKit支持WebRTC

该服务器现在通过LiveKit集成支持WebRTC，实现：

  • 低延迟实时屏幕共享
  • 提升的性能和响应速度
  • 相比传统VNC更高效的网络效率
  • 根据网络条件自动调整质量

要使用WebRTC功能，您需要：

  1. 设置一个LiveKit服务器或使用LiveKit Cloud
  2. 如上所示配置LiveKit环境变量

开发者指南

克隆仓库

# 克隆仓库
git clone https://github.com/yourusername/mcp-remote-macos-use.git
cd mcp-remote-macos-use

构建Docker镜像

# 构建Docker镜像
docker build -t mcp-remote-macos-use .

跨平台发布

要为多个平台发布Docker镜像，可以使用docker buildx命令。按照以下步骤操作：

  1. 创建一个新的构建实例（如果尚未创建）：

    docker buildx create --use

  2. 构建并推送多平台镜像：

    docker buildx build --platform linux/amd64,linux/arm64 -t buryhuang/mcp-remote-macos-use:latest --push .

  3. 验证镜像是否可用于指定的平台：

    docker buildx imagetools inspect buryhuang/mcp-remote-macos-use:latest

使用

该服务器通过MCP工具提供远程macOS功能。

工具规格

该服务器提供了以下工具用于远程macOS控制：

remote_macos_get_screen

连接到远程macOS机器并获取远程桌面的截图。

remote_macos_send_keys

向远程macOS机器发送键盘输入。

remote_macos_mouse_move

移动远程macOS机器上的鼠标指针到指定坐标，自动进行坐标缩放。

remote_macos_mouse_click

在远程macOS机器上的指定坐标处执行鼠标点击，自动进行坐标缩放。

remote_macos_mouse_double_click

在远程macOS机器上的指定坐标处执行鼠标双击，自动进行坐标缩放。

remote_macos_mouse_scroll

在远程macOS机器上的指定坐标处执行鼠标滚动，自动进行坐标缩放。

remote_macos_open_application

打开/激活应用程序并返回其PID以便进一步交互。

remote_macos_mouse_drag_n_drop

在远程macOS机器上从起点拖动到终点，自动进行坐标缩放。

所有工具都使用设置期间配置的环境变量，而不是需要连接参数。

限制

  • 认证支持：
    • 只支持Apple认证（协议30）

安全说明

https://support.apple.com/guide/remote-desktop/encrypt-network-data-apdfe8e386b/mac https://cafbit.com/post/apple_remote_desktop_quirks/

我们只支持协议30，它使用Diffie-Hellman密钥协议和512位素数。此协议由macOS 11至macOS 12在与OS X 10.11或更早版本的客户端通信时使用。

以下是转换为markdown表格的信息：

macOS版本运行远程桌面macOS客户端版本认证控制和观察复制项目或安装包所有其他任务协议版本
macOS 13macOS 132048位RSA主机密钥2048位RSA主机密钥2048位RSA主机密钥认证，然后是128位AES2048位RSA主机密钥36
macOS 13macOS 10.12Secure Remote Password (SRP)协议仅限本地。如果绑定到LDAP或macOS服务器是10.11或更早版本，则使用Diffie-Hellman (DH)SRP或DH，128位AESSRP或DH认证，然后是128位AES2048位RSA主机密钥35
macOS 11至macOS 12macOS 10.12至macOS 13Secure Remote Password (SRP)协议仅限本地，如果绑定到LDAP则使用Diffie-HellmanSRP或DH 1024位，128位AESmacOS 13至macOS 10.13使用2048位RSA主机密钥macOS 10.13或更高版本使用2048位RSA主机密钥33
macOS 11至macOS 12OS X 10.11或更早版本DH 1024位DH 1024位，128位AES使用512位素数的Diffie-Hellman密钥协议使用512位素数的Diffie-Hellman密钥协议30

始终使用安全、经过身份验证的连接访问远程macOS机器。此工具应仅用于您信任且有权访问的服务器。

MacOS代理客户端

一个轻量级代理，连接到LiveKit房间以进行远程macOS控制。我们的专有“keep_eyes_open”系统显著增强了响应性和性能，通过持续的环境感知而没有轮询开销。这允许通过高效双向数据通道近乎实时地执行命令和反馈。

许可证

MIT