MCP 服务 · 连接本地自动化实例

端点与鉴权

MCP 服务默认随 WebUI 启动，路径为 /mcp，WebUI 默认端口为 25548。因此本地 SSE 地址通常是：

http://127.0.0.1:25548/mcp/sse

可以在客户端请求头中携带 WebUI 密码：

Authorization: Bearer <WebUI 密码>

部分客户端只接受 URL，也可以使用 X-API-Key 请求头，或把密码放到?key= 查询参数中。查询参数会出现在 URL 与日志里，优先使用请求头。密码修改后需要重启 WebUI 才会生效。

独立运行（可选）

默认不需要额外启动 MCP。需要把它与 WebUI 分开调试时，可运行：

uv run python mcp_server_sse.py

独立模式监听 22268 端口。注意该端口也是 OCR 服务的默认端口；同机运行时要先处理端口冲突。

客户端配置示例

下面是最小配置。把 <WebUI 密码> 替换为你的实际密码，不要把真实密码提交到代码仓库。

{
  "mcpServers": {
    "azurpilot": {
      "url": "http://127.0.0.1:25548/mcp/sse",
      "headers": {
        "Authorization": "Bearer <WebUI 密码>"
      }
    }
  }
}

云服务器或另一台内网设备访问时，把 127.0.0.1 换成实际 IP，并同步修改密码与防火墙规则。如果 WebUI 端口被改过，MCP 路径也跟随 WebUI 端口。

可用工具

当前版本共 18 个工具。工具集合可能随版本更新；以你本地运行时的 MCP 列表和仓库文档为准。

实例管理

list_instances列出所有实例

get_status获取实例状态

start_instance启动实例

stop_instance停止实例

任务管理

list_tasks列出所有任务

get_task_help获取任务帮助

trigger_task触发任务

get_scheduler_queue获取调度队列

clear_scheduler_queue清空调度队列

监控与信息

get_current_running_task获取当前运行任务

get_resources获取资源状态

get_config获取实例配置

get_recent_logs读取最近日志

get_screenshot获取当前截图

配置与维护

update_config更新实例配置

restart_emulator重启模拟器

restart_adb重启 ADB

update_alas更新 AzurPilot

部署与使用建议

默认只在本机使用。
使用强密码，并定期检查谁可以访问 WebUI 和 MCP。
允许 Agent 调用启停或更新工具前，先确认操作范围与误操作代价。
日志、截图和配置可能包含账号相关信息；分享前先脱敏。