熠测

ember-mcp

通过 MCP 在 Cursor 中操作 Ember 云平台

ember-mcp

ember-mcp 是 Ember 云平台配套的 MCP Server(Model Context Protocol 服务器) 与 CLI,让 Cursor、Claude Code 等 Agent 通过自然语言调用平台 API。

能做什么

MCP 工具说明
ember_cheat_sheet平台使用说明
ember_list_devices列出可用云真机
ember_run_instruction执行自然语言 UI 自动化
ember_get_execution查询执行状态与结果

CLI 侧:

  • ember-mcp login — 登录平台
  • ember-mcp doctor — 环境诊断
  • ember-mcp serve — 启动 MCP 服务(供 Cursor 连接)

安装

cd ember-mcp
pip install -e ".[dev]"

(包随 Ember 云平台交付或内部源码仓库提供,非熠测桌面端安装包内容。)

本地开发配置

export EMBER_API_URL=http://localhost:5173
export EMBER_DEBUG_TEMPLATE_ID=42   # 与 lmweb .env VITE_UI_GENIE_AI_DEBUG_* 一致

ember-mcp login
ember-mcp doctor
ember-mcp serve

Cursor 集成

  1. 打开 Cursor Settings → MCP
  2. 参考 cursor-mcp.example.json 添加 server 配置
  3. Command 指向 ember-mcp serve,并注入 EMBER_API_URL 等环境变量
  4. 在对话中即可让 Agent 列设备、跑指令、查状态

架构位置

Cursor / Claude Code
        │ MCP

   ember-mcp (本地)
        │ HTTPS

   Ember 云平台 API (lmweb + 后端服务)


   UI-Genie / 云真机

安全建议

  • AccessToken 与登录态仅存本机,勿提交到版本库
  • 生产环境使用 HTTPS 与租户级权限控制
  • CI 场景使用专用 Token,而非个人账号

相关