mcp-remote-macos-use 的安装和配置教程

1. 项目基础介绍和主要编程语言

mcp-remote-macos-use 是一个开源项目，旨在提供一个能够使 AI 完全控制远程 macOS 系统的 MCP 服务器。它是一个直接替代 OpenAI Operator 的解决方案，专门为具有完全桌面能力的自主 AI 代理优化，且不需要安装任何额外的软件。

该项目主要用于远程操作 macOS 系统，支持各种自动化任务，如社交媒体自动化、应用操作等。项目主要使用的编程语言是 Python，同时也涉及到了 Docker 容器技术。

2. 项目使用的关键技术和框架

• Docker: 用于容器化应用，确保在不同环境中的一致性和便捷部署。
• WebRTC: 通过 LiveKit 集成，提供低延迟的实时屏幕共享功能。
• Python: 用于编写服务器端的控制逻辑和脚本。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• macOS 或 Linux 操作系统
• Docker Desktop 已经安装并运行
• 目标 macOS 系统上已启用屏幕共享功能

安装步骤

步骤 1: 克隆项目仓库

首先，您需要在您的本地环境中克隆项目仓库：

git clone https://github.com/baryhuang/mcp-remote-macos-use.git
cd mcp-remote-macos-use

步骤 2: 构建 Docker 镜像

接下来，构建项目的 Docker 镜像：

docker build -t mcp-remote-macos-use .

步骤 3: 配置 Claude Desktop

为了使用 Docker 镜像，您需要配置 Claude Desktop 来连接到您的 MCP 服务器。在 Claude 配置中添加以下内容：

{
  "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",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ]
    }
  }
}

请确保替换 your_macos_username, your_macos_password, 和 your_macos_hostname_or_ip 为您的 macOS 系统的实际登录凭据和 IP 地址或主机名。

步骤 4: 启动 MCP 服务器

使用以下命令启动 MCP 服务器：

docker run -d -e MACOS_USERNAME=your_macos_username -e MACOS_PASSWORD=your_macos_password -e MACOS_HOST=your_macos_hostname_or_ip buryhuang/mcp-remote-macos-use:latest

再次确保替换环境变量为您的实际信息。

完成以上步骤后，您的 MCP 服务器应该已经准备好接受来自 Claude Desktop 的连接，并且可以开始远程操作 macOS 系统了。