DevEco MCP

DevEco Toolbox是一个工具集(依赖于DevEco Studio)。在不打开DevEco Studio的情况下，你可以用它在AI IDE中完成鸿蒙应用开发的大多数工作。

mcp tools合集

使用npx安装MCP服务

• DEVECO_PATH DevEco Studio的安装路径

{
  "mcpServers": {
    "deveco-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@deveco-codegenie/mcp"
      ],
      "env": {
        "DEVECO_PATH": "path/to/your/deveco"
      }
    }
  }
}

特别注意：

• UI 自动化校验verify_ui需额外配置URL等参数才可正常使用，详情可见下文。

UI 自动化校验（verify_ui / get_ui_verification_log / save_ui_screenshot）

基于自然语言测试用例计划，在 HarmonyOS 设备上自动执行 UI 操作并验证结果。

功能特性：

• 自然语言驱动：用中文描述测试步骤，无需编写代码
• 智能 UI 识别：基于 AI 视觉分析自动识别界面元素
• 多种操作支持：点击、滑动、输入文本、长按、启动应用等
• 实时截图验证：每步操作后自动截图验证是否成功
• 截图保存：可将每步截图保存到本地，便于复盘问题
• 日志记录：详细的测试过程日志，便于问题排查

环境要求：

需配置以下环境变量以连接 AI 视觉模型服务（需支持 Function Call，如阿里云百炼 Qwen3-VL）：

MCP 配置示例：

{
  "mcpServers": {
    "deveco-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@deveco-codegenie/mcp"
      ],
      "env": {
        "DEVECO_PATH": "path/to/your/deveco",
        "UI_VERIFY_API_KEY": "your-api-key",
        "UI_VERIFY_BASE_URL": "your-openai-compatible-base-url",
        "UI_VERIFY_MODEL_NAME": "your-model-name"
      }
    }
  }
}

工具名称： verify_ui（执行 UI 校验）

返回字段：successPart（成功步骤描述）、failPart（失败步骤描述）、id（校验任务 ID，供后续查日志或截图使用）。

最佳实践：

在 AI 助手中配置好 MCP 后，建议在测试过程中加入以下指引，让 AI 自动串联完整开发测试流程：

开发完成后，请按以下流程完成验证：
1. 调用 check_ets_files 进行代码迭代直至无语法报错
2. 调用 build_project 编译构建项目
3. 调用 start_app 将应用安装并启动到设备
4. 调用 verify_ui 执行功能验证，用自然语言描述测试步骤和预期结果
5. 若验证失败，根据 failPart 描述定位问题，修复后重新执行上述流程，直到验证通过
6. 如需查看详细日志，使用 get_ui_verification_log 获取运行日志
7. 如需查看每步截图，使用 save_ui_screenshot 将截图保存到本地目录
8. 如需获取界面详细信息，使用 get_app_ui_tree 获取全量结点信息

问题/需求反馈

如果你在配置或使用「DevEco MCP」时遇到任何阻碍，欢迎随时联系我们：

1️⃣ GitHub Issue（技术/需求/缺陷均可） https://github.com/open-deveco/deveco-toolbox/issues

2️⃣ 飞书指导文档 https://my.feishu.cn/wiki/open-deveco/deveco-toolbox

我们珍视每一条反馈——你的 issue & 群消息，就是下一个版本更新的源头！