deveco-server

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

DevEco Toolbox当前包含两个可执行文件：

• deveco-toolbox 用于可视化配置
• deveco-mcp-server 主要的mcp服务

mcp tools合集

主流软件的配置方式

1.在CLI上使用推荐配置项目级MCP
2.支持智能查找当前目录下的鸿蒙工程（多鸿蒙工程不适用），可在父目录使用MCP进行作业。
3.无法获取项目根路径时可通过Init_Project_Path更改初始化路径

{
  "mcpServers": {
    "deveco-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@deveco-codegenie/mcp@beta"
      ],
      "env": {
        "DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
      }
    }
  }
}

{
  "servers": {
    "deveco-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@deveco-codegenie/mcp@beta"
      ],
      "env": {
        "DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
      }
    }
  }
}

{
  "mcpServers": {
    "deveco-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@deveco-codegenie/mcp@beta"
      ],
      "env": {
        "PROJECT_PATH": "${workspaceFolder}",
        "DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
      }
    }
  }
}

{
  "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 一层
      }
    }
  }
}

{
  "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 一层
      }
    }
  }
}

{
  "mcpServers": {
    "deveco-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@deveco-codegenie/mcp@beta"
      ],
      "env": {
        "DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
      }
    }
  }
}

{
  "mcp": {
    "deveco-mcp": {
      "command": ["npx", "-y", "@deveco-codegenie/mcp@beta"],
      "type": "local",
      "enabled": true,
      "environment": {
        "PROJECT_PATH": ".",
        "DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
      }
    }
  }
}

{
  "mcpServers": {
    "deveco-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@deveco-codegenie/mcp@beta"
      ],
      "env": {
        "PROJECT_PATH": ".",
        "DEVECO_PATH": "path/to/your/deveco" // 无需到 bin 一层
      }
    }
  }
}

下载二进制安装并使用

下载

• github

下载安装

MacOS

1. 下载并安装dmg程序；
2. 终端执行如下命令

   xattr -cr /Applications/DevEco\ Toolbox.app
   

Windows

1. 下载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语法

卸载

1. Windows 版本可直接删除，所有数据仅存在该应用所在目录下
2. 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 官方交流群」或扫码加入，群内可快速定位问题、获取最新版本、参与功能投票。