返回 MCP 目录
public公开dns本地运行

mcp-remote-macos-use

首个开源MCP服务器,实现AI全功能控制远程macOS系统,无需额外安装软件,提供完整桌面操作能力。

article

README

🚀 MCP 服务器

MCP 服务器可对远程 macOS 系统进行控制,具备屏幕获取、键盘输入发送、鼠标操作和应用程序管理等功能,能为用户提供便捷的远程操作体验。

🚀 快速开始

环境变量配置

MCP 服务器运行时所需的环境变量如下: | 变量名 | 描述 | |------|------| | MCP_SERVER_HOST | MCP 服务器的主机地址,默认值为 localhost。| | MCP_SERVER_PORT | MCP 服务器监听的端口,整数类型,默认值为 5000。|

安装与运行

  1. 克隆仓库
    git clone https://github.com/yourusername/mcp-server.git
    cd mcp-server
    
  2. 安装依赖
    pip install -r requirements.txt
    
  3. 启动服务器
    python server.py
    

✨ 主要特性

MCP 服务器提供对远程 macOS 系统的控制功能,涵盖屏幕获取、键盘输入发送、鼠标操作以及应用程序管理等方面。以下是具体工具说明:

remote_macos_get_screen

连接到远程 macOS 机器并获取其屏幕截图。

remote_macos_send_keys

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

remote_macos_mouse_move

将鼠标光标移动到指定坐标,支持自动缩放。

remote_macos_mouse_click

在指定坐标执行鼠标单击操作,支持自动缩放。

remote_macos_mouse_double_click

在指定坐标执行鼠标双击操作,支持自动缩放。

remote_macos_mouse_scroll

在指定坐标执行鼠标滚动操作,支持自动缩放。

remote_macos_open_application

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

remote_macos_mouse_drag_n_drop

从起始点拖动到终点执行鼠标拖放操作,支持自动缩放。

所有工具均使用在设置过程中配置的环境变量,而不直接要求连接参数。

📦 安装指南

第三方依赖

  • mcp-core, mcp-rs
  • 版本要求>=1.0.0

配置步骤

  1. 下载并安装 MCP 服务器。
  2. 配置环境变量:
    export MCP_SERVER_HOST=your-host
    export MCP_SERVER_PORT=your-port
    
  3. 启动服务:
    mcp-server start
    

💻 使用示例

基础用法

import mcp

# 初始化 MCP 客户端
client = mcp.Client(host='localhost', port=5000)

# 发送键盘输入
client.send_keys('hello')

# 获取屏幕截图并保存
screenshot = client.get_screen()
screenshot.save('screen.png')

📚 详细文档

表格信息

| macOS 版本运行 Remote Desktop | macOS 客户端版本 | 认证方式 | 控制与观察 | 复制项或安装包 | 其他任务 | 协议版本 | |-----------------------------|-----------------|----------|------------|-----------------|-----------|------------| | macOS 13 | macOS 13 | 2048-bit RSA 主机密钥 | 2048-bit RSA 主机密钥 | 使用 2048-bit RSA 主机密钥进行身份验证,然后使用 128-bit AES 加密 | 2048-bit RSA 主机密钥 | 36 | | macOS 13 | macOS 10.12 | SRP 协议(本地仅)或 DH 协议(绑定到 LDAP 或 macOS 服务器版本为 10.11 或更早) | SRP 或 DH,使用 128-bit AES 加密 | 使用 SRP 或 DH 进行身份验证,然后使用 128-bit AES 加密 | 2048-bit RSA 主机密钥(macOS 13 或更高版本) | 35 | | macOS 11 到 macOS 12 | macOS 10.12 到 macOS 13 | SRP 协议(本地仅)或 DH 协议 | 使用 SRP 或 DH 进行身份验证,然后使用 128-bit AES 加密 | 使用 2048-bit RSA 主机密钥进行身份验证 | - | 34 | | macOS 11 到 macOS 12 | macOS 10.11 | DH 协议 | 使用 DH 进行身份验证,然后使用 128-bit AES 加密 | 使用 2048-bit RSA 主机密钥进行身份验证 | - | 33 |

🔧 技术细节

认证支持

  • Apple 认证(协议 30):仅支持 macOS 11 到 macOS 12 之间的版本。

安全提示

在访问远程 macOS 机器时,请确保使用安全的、经过身份验证的连接。本工具仅供访问受信任且获得权限的服务器使用。

📄 许可证

文档未提及相关信息,故跳过展示。

问题与支持

如遇到问题,请联系技术支持邮箱:support@mcp-server.com。


以上为 MCP 服务器的使用指南,感谢您的使用!

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端