DevEco Toolbox
DevEco Toolbox是一个工具集(依赖于DevEco Studio)。在不打开DevEco Studio的情况下，你可以用它在Trae、Curosr、Visual Studio Code等AI IDE中完成鸿蒙应用开发的大多数工作。
写在前面
- 在2026年的HDC大会上，华为官方正式发布了DevEco CLI（鸿蒙能力命令行工具）。经过我们的试用，相较于 MCP 方案，命令行方式在 Agent 场景下更具优势，且官方工具已覆盖我们现有工具，包括LSP静态语法检查在内的绝大部分能力。
- 更重要的是，华为官方采用了开源共建的模式DevEco CLI官方代码仓，大家可以在官方仓库提交 Issue、贡献 PR，甚至基于此打造自己的 CLI 工具————这对鸿蒙生态的长远发展意义重大。
- 鉴于此，我们决定后续不再对该 MCP 工具进行深度功能迭代，仅对该工具进行必要的缺陷修复。再次感谢大家的支持！
DevEco Toolbox当前包含两个可执行文件：
deveco-toolbox 用于可视化配置deveco-mcp-server 主要的mcp服务
| tool_name |
主要功能 |
harmonyos_knowledge_search |
查询鸿蒙云端知识库（已实时更新api23) |
check_ets_files |
对ets文件进行语法检查 |
check_cpp_files |
对cpp文件进行静态语法检查 |
build_project |
进行项目构建 |
start_app |
在模拟器或者真机中启动应用，支持启动模拟器或选择已连接的真机 |
verify_ui（可选） |
基于自然语言测试用例计划，在 HarmonyOS 设备上自动执行 UI 操作并验证结果 |
get_hilog_or_faultlog_recent |
获取模拟器/真机的hilog/faultlog日志 |
get_app_ui_tree |
获取app当前页面的ui树 |
init_project_path（可选） |
初始化项目路径 |
project_sync |
对鸿蒙项目进行初始化操作 |
perform_ui_action |
在已启动的app页面中执行点击或者输入动作 |
主流软件的配置方式
1.在CLI上使用推荐配置项目级MCP
2.支持智能查找当前目录下的鸿蒙工程（多鸿蒙工程不适用），可在父目录使用MCP进行作业。
3.无法获取项目根路径时可通过Init_Project_Path更改初始化路径
Cursor
{
"mcpServers": {
"deveco-mcp": {
"command": "npx",
"args": [
"-y",
"@deveco-codegenie/mcp@beta"
],
"env": {
"DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
}
}
}
}
VSCode
{
"servers": {
"deveco-mcp": {
"command": "npx",
"args": [
"-y",
"@deveco-codegenie/mcp@beta"
],
"env": {
"DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
}
}
}
}
Trae
{
"mcpServers": {
"deveco-mcp": {
"command": "npx",
"args": [
"-y",
"@deveco-codegenie/mcp@beta"
],
"env": {
"PROJECT_PATH": "${workspaceFolder}",
"DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
}
}
}
}
Qoder
{
"mcpServers": {
"deveco-mcp": {
"command": "npx",
"args": [
"-y",
"@deveco-codegenie/mcp@beta"
],
"env": {
"PROJECT_PATH": "path/to/your/project",//可不填写，通过调用init_project_path初始化
"DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
}
}
}
}
CodeBuddy
{
"mcpServers": {
"deveco-mcp": {
"command": "npx",
"args": [
"-y",
"@deveco-codegenie/mcp@beta"
],
"env": {
"PROJECT_PATH": "path/to/your/project",//可不填写，通过调用init_project_path初始化
"DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
}
}
}
}
Claude Code
{
"mcpServers": {
"deveco-mcp": {
"command": "npx",
"args": [
"-y",
"@deveco-codegenie/mcp@beta"
],
"env": {
"DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
}
}
}
}
Opnecode
{
"mcp": {
"deveco-mcp": {
"command": ["npx", "-y", "@deveco-codegenie/mcp@beta"],
"type": "local",
"enabled": true,
"environment": {
"PROJECT_PATH": ".",
"DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
}
}
}
}
Qoder CLI
{
"mcpServers": {
"deveco-mcp": {
"command": "npx",
"args": [
"-y",
"@deveco-codegenie/mcp@beta"
],
"env": {
"PROJECT_PATH": ".",
"DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
}
}
}
}
下载二进制安装并使用
下载
下载安装
MacOS
- 下载并安装dmg程序；
- 终端执行如下命令
xattr -cr /Applications/DevEco\ Toolbox.app
Windows
- 下载zip包并解压；
特别注意：
- 尽量避免在安装路径中包含特殊字符或中文，部分AI IDE不支持解析此类路径。
快速启动
- MacOS上，可点击
DevEco Toolbox app图标快速启动；
- Windows上，可点击
deveco-toolbox.exe图标快速启动；
启动后会自动探测本机安装的DevEco Studio路径，若未检测到，需要手动指定。
在可选配置中，可单独配置模拟器路径和镜像路径，如有需要可手工指定路径。
界面上已经放置了添加到Trae和Cursor的按钮，点击即可将MCP配置添加到Trae或Cursor中。
如果是其他IDE，可通过复制MCP JSON配置的方式添加到对应的IDE中。
{
"mcpServers": {
"deveco-mcp": {
"command": "cmd",
"args": [
"/C",
"D:\\program_files\\deveco-mcp_x64_windows\\deveco-mcp-server.exe"
],
"env": {
"PROJECT_PATH": "${workspaceFolder}"
}
}
}
}
特别注意：
- 如果IDE不支持
${workspaceFolder}变量替换，需要手动替换为指定路径。
ArkTS语法校验插件
本插件基于鸿蒙官方DevEco Studio编辑器的LSP语言服务器开发，更贴近官方，检查错误更加全面
安装方式
安装方式一：在 Toolbox 中直接一键安装 ArkTS 高亮插件
安装方式二：手动安装 ArkTS 高亮插件
若本地没有配置对应IDE的bin路径为环境变量，需要手动安装 ArkTS 插件。
打开Toolbox所在目录，找到 ArkTS 高亮插件 vsix，将插件拖到对应 IDE 插件市场进行安装，安装好后，重启ide。
使用方式
打开ide后，右下角有一个状态，表示插件正在初始化，当插件初始化完成后，会变为白色，表示可以正常校验ArkTS语法
卸载
- Windows 版本可直接删除，所有数据仅存在该应用所在目录下
- mac 版本在此基础上还需额外执行如下指令：
rm -r ~/Library/Application\ Support/deveco-toolbox
问题/需求反馈
如果你在配置或使用[鸿蒙MCP工具箱」时遇到任何阻碍，欢迎随时联系我们：
1️⃣ GitHub Issue（技术/需求/缺陷均可）
https://github.com/open-deveco/deveco-toolbox/issues
2️⃣ 飞书指导文档
https://my.feishu.cn/wiki/open-deveco/deveco-toolbox
3️⃣ 飞书答疑群（实时互动）(1、2群已满，3群开放中)
搜索「鸿蒙 MCP 官方交流群」或扫码加入，群内可快速定位问题、获取最新版本、参与功能投票。
我们珍视每一条反馈——你的 issue & 群消息，就是下一个版本更新的源头！
评论