{"name":"io.github.xiaoxuzhu303-prog/harmony-mcp","slug":"xiaoxuzhu303-prog-harmony-mcp","title":null,"description":"AI copilot for WeChat Mini Program - compile-fix, size analysis, compliance. 20 tools.","url":"https://mcp.market/server/xiaoxuzhu303-prog-harmony-mcp","rating":null,"grade":"C","score":65,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":9,"stars":null,"forks":null,"downloads_week":65,"last_push_at":null,"license":"MIT"},"uptime":null,"claimed":false,"transport":"npm","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/xiaoxuzhu303-prog/harmony-mcp","website":null,"version":"0.4.2","remotes":[],"packages":[{"registryType":"npm","identifier":"@yujiamei/harmony-mcp","version":"0.4.2","transport":{"type":"stdio"}}],"tools":[{"name":"harmony_file_pull","description":"从鸿蒙设备拉取文件到本地指定路径。当用户说「把设备上的文件拉下来」时调用。","write_action":false,"price_micros":0,"input_schema":null},{"name":"harmony_file_push","description":"将本地文件推送到鸿蒙设备的指定路径。当用户说「把文件传到设备上」时调用。","write_action":false,"price_micros":0,"input_schema":null},{"name":"harmony_install","description":"将 HAP 安装包安装到指定鸿蒙设备。当用户说「装到设备上」「安装这个 hap」时调用。安装前建议先用 harmony_list_devices 确认目标设备。多设备时必须指定 target。","write_action":false,"price_micros":0,"input_schema":null},{"name":"harmony_list_devices","description":"列出当前已连接的鸿蒙设备和模拟器（connectKey、状态、类型）。当用户问「有哪些鸿蒙设备」或在执行其他鸿蒙操作前需要确认目标设备时调用。多设备场景下，其他鸿蒙工具需要用此处返回的 connectKey 指定 target。","write_action":false,"price_micros":0,"input_schema":null},{"name":"harmony_log","description":"抓取设备最近的 hilog 日志（默认最近 200 行）。当用户说「看看日志」「设备上报什么错了」时调用。可用 keyword 过滤。","write_action":false,"price_micros":0,"input_schema":null},{"name":"harmony_ready_check","description":"一次性检测鸿蒙开发环境：HDC 路径、HDC 版本、已连接设备。返回每项 pass/warn/fail 状态和修复 SOP。在执行鸿蒙设备操作前建议先调用确认环境就绪。如果返回 NOT_READY，请根据 failedChecks 的 sop 逐项引导用户修复。","write_action":false,"price_micros":0,"input_schema":null},{"name":"harmony_start","description":"在指定设备上启动应用的某个 Ability（相当于预览/拉起应用）。当用户说「在设备上跑起来」「启动这个应用」时调用。需要提供 bundleName 和 abilityName。","write_action":false,"price_micros":0,"input_schema":null},{"name":"harmony_uninstall","description":"从指定鸿蒙设备卸载应用（按 bundleName）。当用户说「卸载这个应用」时调用。多设备时必须指定 target。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_audit","description":"全面代码质量审计：11 条运行时规则扫描 + A/B/C/D 评分 + 具体问题列表。当用户说「帮我检查代码质量」「项目有没有问题」时调用。返回 suggestedActions 时请按顺序修复。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_build_npm","description":"构建小程序项目的 npm 依赖。当 wechat_diagnose 返回 REBUILD_NPM 指令、或用户新安装了 npm 包后需要调用此工具。构建完成后建议重新编译验证。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_cli_login","description":"登录微信开发者工具（会弹出二维码，需要用户手机微信扫码确认）。当其他工具返回 NEED_LOGIN 状态时，必须先调用此工具完成登录，再重试之前的操作。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_close_project","description":"关闭当前在微信开发者工具中打开的项目。当需要切换到另一个项目时使用。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_compliance_check","description":"合规预检：扫描隐私 API 调用（15 条规则）、检查权限声明、推断所需类目、标注个人主体限制。发版前调用避免审核被拒。返回缺失权限 + suggestedPatch（可直接帮用户补全 permission 配置）。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_config_validate","description":"校验 project.config.json 和 app.json 配置文件，检查 appid 格式、pages 为空、必填字段缺失等常见错误。当用户问「配置有没有问题」时调用。返回 suggestedActions 时请按顺序执行。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_dependency_check","description":"检查 npm 依赖状态：未构建的依赖、已知体积大户（lodash/moment 等）。当用户问「依赖有问题吗」或发版前调用。返回 suggestedActions 时请按顺序执行。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_diagnose","description":"触发小程序项目编译，捕获编译错误并结构化分析，给出修复建议。支持自动识别 uni-app/Taro/mpx 等跨框架项目。 如果返回 status=\"COMPILATION_FAILED\"，你必须根据每个 error 的 agentActionHint 执行对应操作： - READ_FILE_AND_PATCH: 立刻读取 error.file 的 error.line 行附近代码，分析并修复错误 - ADD_PAGE_TO_APP_JSON: 在 app.json 的 pages 数组中添加缺失的页面路径 - REBUILD_NPM: 调用 wechat_build_npm 工具重新构建 npm - INSTALL_DEPENDENCY: 执行 npm install 安装缺失的依赖包 - FIX_CONFIG: 读取并修复对应的配置文件 - CHECK_COMPONENT_PATH: ","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_init_project","description":"在指定目录创建一个标准的微信小程序项目骨架，包含 project.config.json、app.json、app.js、首页等基础文件。 支持三种模板：blank（空白项目）、tabbar（带底部导航）、subpackage（带分包结构）。 创建完成后建议调用 wechat_open_project 在开发者工具中打开。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_open_project","description":"在微信开发者工具中打开指定项目。通常由自动恢复链路内部调用，用户一般不需要直接使用。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_package_size","description":"分析小程序包体积，返回主包/分包体积、文件明细、三方库排行、体积炸弹警告。当用户问「包超了吗」「体积多大」时调用。 如果 useOfficialReport=true 会触发一次预览编译获取精准数据。主包超 1.5MB 时建议调用 wechat_subpackage_suggest 获取分包方案。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_page_list","description":"列出小程序所有页面（主包 + 分包），标注分包归属和页面总数。当用户问「有哪些页面」「页面列表」时调用。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_preview","description":"预览小程序项目，生成二维码用于手机扫码预览。如果用户只是想检查编译是否通过，应优先使用 wechat_diagnose 而非此工具。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_project_info","description":"读取小程序项目全貌：AppID、页面列表、分包结构、编译配置、窗口设置。当用户第一次提到一个项目时应主动调用。支持 uni-app/Taro/mpx 跨框架自动识别（所有工具共享此能力）。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_publish","description":"一键发版：自动读取当前版本号并递增、构建 npm 依赖、上传代码到微信后台。调用前必须先调用 wechat_diagnose 确认编译零错误，只有编译通过才能发版，否则应先引导用户修复编译错误。 支持自动识别 uni-app/Taro/mpx 等跨框架项目。","write_action":true,"price_micros":0,"input_schema":null},{"name":"wechat_ready_check","description":"一次性检查微信开发者工具全链路状态：CLI 路径、进程运行、登录态、服务端口、项目合法性和可预览状态。 返回每个检查项的 pass/warn/fail 状态和具体修复 SOP。 建议在执行 preview/upload/diagnose 等操作前先调用此工具确认环境就绪。 如果返回 status=\"NOT_READY\"，你必须根据 failedChecks 中每项的 sop 字段引导用户逐一修复。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_reset_fileutils","description":"重置微信开发者工具的文件监听缓存。当开发者工具出现文件不同步、修改不生效等异常时使用。通常由自动恢复链路内部调用。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_self_test","description":"检测 harmony-mcp 运行环境是否就绪（CLI 路径、开发者工具进程、Node 版本等）。当用户第一次使用本工具或询问'连上了吗/能用吗'时，应主动调用此工具进行自检，并将结果用自信的口吻告知用户。本工具同时包含隐私安全声明，请在用户有安全顾虑时引用。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_subpackage_suggest","description":"智能分包建议：分析页面依赖关系，生成分包方案 + 可直接使用的 app.json 配置片段 + 体积归因 + 预加载配置 + 分包后体积模拟。 当主包超 1.5MB 或 wechat_package_size 建议分包时调用。拿到 configSnippet 后，读取 app.json 合并 subpackages 并从 pages 中移除已分包页面。","write_action":false,"price_micros":0,"input_schema":null},{"name":"wechat_upload","description":"上传小程序代码到微信后台。通常不需要直接调用此工具，推荐使用 wechat_publish（一键发版）来完成完整的发布流程。","write_action":true,"price_micros":0,"input_schema":null}],"scan":{"score":65,"grade":"C","scanned_at":"2026-09-27T12:17:43.699Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-27T12:17:43.701Z","components":{"code":{"score":25,"max":25,"notes":["67 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":12,"max":15,"notes":["local package, no credentials required"]},"maintenance":{"score":3,"max":15,"notes":["repository not readable: repo not found"]},"identity":{"score":2,"max":10,"notes":["no repository or website to verify"]}},"findings":[],"inputs":{"packages":[{"registryType":"npm","identifier":"@yujiamei/harmony-mcp","version":"0.4.2","found":true,"license":"MIT","hasInstallScripts":false,"dependencyCount":2,"publishedAt":"2026-06-01T02:08:06.537Z","repositoryUrl":"git+https://github.com/xiaoxuzhu303-prog/harmony-mcp.git","weeklyDownloads":65}],"repo":{"found":false,"owner":"xiaoxuzhu303-prog","repo":"harmony-mcp","error":"repo not found"},"icon":{"url":null,"source":"none"},"presence":{"stars":null,"forks":null,"downloadsWeek":65,"license":"MIT","lastPushAt":null,"score":9}}}},"grade_history":[],"reviews":[]}