README
🚀 MCP 服务器
MCP 服务器可对远程 macOS 系统进行控制,具备屏幕获取、键盘输入发送、鼠标操作和应用程序管理等功能,能为用户提供便捷的远程操作体验。
🚀 快速开始
环境变量配置
MCP 服务器运行时所需的环境变量如下:
| 变量名 | 描述 |
|------|------|
| MCP_SERVER_HOST | MCP 服务器的主机地址,默认值为 localhost。|
| MCP_SERVER_PORT | MCP 服务器监听的端口,整数类型,默认值为 5000。|
安装与运行
- 克隆仓库:
git clone https://github.com/yourusername/mcp-server.git cd mcp-server - 安装依赖:
pip install -r requirements.txt - 启动服务器:
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
配置步骤
- 下载并安装 MCP 服务器。
- 配置环境变量:
export MCP_SERVER_HOST=your-host export MCP_SERVER_PORT=your-port - 启动服务:
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 服务器的使用指南,感谢您的使用!
微信扫一扫