Harmony MCP Tools

HarmonyOS MCP 工具集

用于 HarmonyOS 开发与分析的 Model Context Protocol (MCP) 服务器集合

 

简介

本仓库包含一系列 MCP (Model Context Protocol) 服务器，旨在增强 Claude Code 在 HarmonyOS 开发、安全分析和工作流自动化方面的能力。

MCP 服务器

支持模块

快速开始

1. 克隆仓库

git clone https://github.com/yonglunyao/harmony-mcp-tools.git
cd harmony-mcp-tools

2. 配置 Claude Desktop

编辑 Claude Desktop 配置文件：

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

3. 添加 MCP 服务器

{
  "mcpServers": {
    "arkts-api-validator": {
      "command": "python",
      "args": ["-m", "arkts_api_validator"],
      "cwd": "{PROJECT_PATH}/arkts-api-validator",
      "env": {
        "PYTHONPATH": "{PROJECT_PATH}/arkts-api-validator/src",
        "HARMONYOS_SDK_PATH": "{DEV_ECO_SDK_PATH}"
      }
    },
    "ark_disasm": {
      "command": "python",
      "args": ["{PROJECT_PATH}/ark-disasm-mcp/ark_disasm_mcp.py"]
    },
    "es2abc": {
      "command": "python",
      "args": ["{PROJECT_PATH}/es2abc-mcp/es2abc_mcp.py"]
    },
    "harmony-build": {
      "command": "python",
      "args": ["{PROJECT_PATH}/harmony-build-mcp/harmony_build_mcp.py"]
    },
    "harmony-tasklist": {
      "command": "python",
      "args": ["-m", "src.main"],
      "cwd": "{PROJECT_PATH}/harmony-tasklist-manager"
    }
  }
}

配置说明: - {PROJECT_PATH}: 替换为本仓库的实际路径 - {DEV_ECO_SDK_PATH}: 替换为 DevEco Studio SDK 路径（通常为 C:\Program Files\Huawei\DevEco Studio\sdk\default）

4. 重启 Claude Desktop

配置完成后，重启 Claude Desktop 以加载 MCP 服务器。

工作流示例

ArkTS 代码校验

User: 检查 @ohos.multimedia.image.ImageSource 是否存在于 SDK 中

字节码分析

User: 将以下 JavaScript 编译为 ABC 并反汇编：
function calculate(a, b) { return a + b; }

HarmonyOS 构建

User: 用 release 模式构建我的 HarmonyOS 项目

任务管理

User: 查找所有 risk_tags 包含 "机检恶意" 的任务

项目结构

harmony-mcp-tools/
├── ark-disasm-mcp/              # ABC 字节码反汇编器
├── arkts-api-validator/         # ArkTS API 校验器
├── es2abc-mcp/                  # JavaScript 转 ABC 编译器
├── harmony-build-mcp/           # HarmonyOS 构建工具
├── harmony_tasklist_manager/    # 任务列表管理器
├── analysis_tool/               # 分析工具
├── data_source/                 # 数据连接器
├── knowledge_manager/           # 知识库 (v1)
├── knowledge_manager_v2/        # 知识库 (v2)
├── report_generator/            # 报告生成器
├── threat_intel/                # 威胁情报
├── vector_search/               # 向量搜索
├── .gitignore
└── README.md

系统要求

• Python: 3.10 或更高版本
• 操作系统: Windows、Linux 或 macOS
• Claude Desktop: 支持 MCP 的最新版本
• DevEco Studio: 用于访问 HarmonyOS SDK (arkts-api-validator)

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

贡献

欢迎贡献！请随时提交 Pull Request。

相关链接

• MCP 协议规范
• HarmonyOS 开发者文档
• Claude Code 文档