使用说明(简要概览,按步骤执行即可):
- 项目概览
- GELab-GUI-MCP-Server 通过 MCP 协议提供服务器端能力,确保客户端可以读取设备列表、启动/继续任务、获取环境与日志等信息。
- 服务器端核心组件基于 LocalServer,负责会话创建、任务执行与日志记录。
- 主要功能点
- 列出已连接设备、获取设备尺寸、对设备执行 GUI Agent 任务、返回执行过程中的中间日志和最终结果。
- 支持多设备并发执行任务、日志记录与图片保存,方便离线分析与回溯。
- 提供不同的 MCP 实现版本(简化版、带注释的详细版、带结果可视化的版本),方便集成与扩展。
- 安装与启动步骤(简化版)
- 确保安装了 Python 环境并获得仓库依赖(通常需安装 Python3.12+、依赖库等,参阅仓库 README 的安装/环境要求)。
- 配置服务器参数:在 mcp_server_config.yaml 或相关启动脚本中设置服务器端口与日志路径等信息。
- 启动服务器:运行相应的 MCP 服务器入口脚本,如 python mcp_server/simple_gelab_mcp_server.py(或详细版脚本),服务器启动后监听指定端口 bereit。
- 使用 MCP 客户端连接:根据客户端配置,将服务器连接信息(名称、启动命令、参数)提供给 MCP 客户端进行连接与调用。
- 服务器配置(供 MCP 客户端读取的配置信息示例说明)
- server name: Gelab-GUI-MCP-Server
- command:用于启动服务器的命令,例如运行入口脚本的命令
- args:启动参数(如端口、传输协议等),用于客户端建立连接时的初始参数 说明:客户端仅需要连接信息,具体服务器端实现的启动与运行由服务器脚本/配置管理,客户端不需要修改代码。
- 基本使用方法
- 客户端调用 list_connected_devices 获取连接的设备列表。
- 调用 ask_agent 传入 device_id、task 等参数,启动新的任务(会话将被创建)。
- 通过返回的 session_id 在后续需要续航任务时调用 ask_agent_continue 或 continue 类 API。
- 查看中间日志、截图及最终结果,必要时调整模型配置与参数。
信息
分类
桌面与硬件