Remote macOS Use

Name: Remote macOS Use
Author: baryhuang

baryhuang

开始使用源码仓库

Lets agents control local or remote macOS desktops for automation without extra API keys.

接入配置

选择客户端，复制配置，再按项目文档补齐环境变量。

一键添加到 Cursor 一键添加到 VS Code

claude mcp add remote-macos-use --env MACOS_USERNAME='<MACOS_USERNAME>' --env MACOS_PASSWORD='<MACOS_PASSWORD>' --env MACOS_HOST='<MACOS_HOST>' -- docker run -i -e 'MACOS_USERNAME={{config.MACOS_USERNAME}}' -e 'MACOS_PASSWORD={{config.MACOS_PASSWORD}}' -e 'MACOS_HOST={{config.MACOS_HOST}}' --rm buryhuang/mcp-remote-macos-use:latest

~/.codex/config.toml

[mcp_servers.remote-macos-use]
command = "docker"
args = ["run", "-i", "-e", "MACOS_USERNAME={{config.MACOS_USERNAME}}", "-e", "MACOS_PASSWORD={{config.MACOS_PASSWORD}}", "-e", "MACOS_HOST={{config.MACOS_HOST}}", "--rm", "buryhuang/mcp-remote-macos-use:latest"]
env = { MACOS_USERNAME = "<MACOS_USERNAME>", MACOS_PASSWORD = "<MACOS_PASSWORD>", MACOS_HOST = "<MACOS_HOST>" }

# codex mcp add remote-macos-use --env MACOS_USERNAME='<MACOS_USERNAME>' --env MACOS_PASSWORD='<MACOS_PASSWORD>' --env MACOS_HOST='<MACOS_HOST>' -- docker run -i -e 'MACOS_USERNAME={{config.MACOS_USERNAME}}' -e 'MACOS_PASSWORD={{config.MACOS_PASSWORD}}' -e 'MACOS_HOST={{config.MACOS_HOST}}' --rm buryhuang/mcp-remote-macos-use:latest

~/.cursor/mcp.json

{
  "mcpServers": {
    "remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME={{config.MACOS_USERNAME}}",
        "-e",
        "MACOS_PASSWORD={{config.MACOS_PASSWORD}}",
        "-e",
        "MACOS_HOST={{config.MACOS_HOST}}",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ],
      "env": {
        "MACOS_USERNAME": "<MACOS_USERNAME>",
        "MACOS_PASSWORD": "<MACOS_PASSWORD>",
        "MACOS_HOST": "<MACOS_HOST>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "remote-macos-use": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME={{config.MACOS_USERNAME}}",
        "-e",
        "MACOS_PASSWORD={{config.MACOS_PASSWORD}}",
        "-e",
        "MACOS_HOST={{config.MACOS_HOST}}",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ],
      "env": {
        "MACOS_USERNAME": "<MACOS_USERNAME>",
        "MACOS_PASSWORD": "<MACOS_PASSWORD>",
        "MACOS_HOST": "<MACOS_HOST>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME={{config.MACOS_USERNAME}}",
        "-e",
        "MACOS_PASSWORD={{config.MACOS_PASSWORD}}",
        "-e",
        "MACOS_HOST={{config.MACOS_HOST}}",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ],
      "env": {
        "MACOS_USERNAME": "<MACOS_USERNAME>",
        "MACOS_PASSWORD": "<MACOS_PASSWORD>",
        "MACOS_HOST": "<MACOS_HOST>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME={{config.MACOS_USERNAME}}",
        "-e",
        "MACOS_PASSWORD={{config.MACOS_PASSWORD}}",
        "-e",
        "MACOS_HOST={{config.MACOS_HOST}}",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ],
      "env": {
        "MACOS_USERNAME": "<MACOS_USERNAME>",
        "MACOS_PASSWORD": "<MACOS_PASSWORD>",
        "MACOS_HOST": "<MACOS_HOST>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME={{config.MACOS_USERNAME}}",
        "-e",
        "MACOS_PASSWORD={{config.MACOS_PASSWORD}}",
        "-e",
        "MACOS_HOST={{config.MACOS_HOST}}",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ],
      "env": {
        "MACOS_USERNAME": "<MACOS_USERNAME>",
        "MACOS_PASSWORD": "<MACOS_PASSWORD>",
        "MACOS_HOST": "<MACOS_HOST>"
      }
    }
  }
}

需要的环境变量

MACOS_USERNAME
MACOS_PASSWORD
MACOS_HOST

把占位值换成你自己的密钥；不要把密钥提交到代码仓库。

接入配置

需要的环境变量

相关推荐