harmony-build 0.2.0

package/dist/src/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * harmony-build MCP Server 入口
+ *
+ * 把 7 个独立的 harmony-* MCP server（hdc / hvigor / profiler /
+ * arkanalyzer / arkcheck / knowledge / dev）合并成 1 个进程 + 1 个 stdio 连接。
+ *
+ * 工具名加 `<namespace>_` 前缀避免冲突，例如：
+ *   - hdc_list_devices / hdc_install_hap
+ *   - hvigor_build_hap / hvigor_clean
+ *   - dev_run_app / dev_start_log_stream
+ *   - profiler_capture_trace / profiler_cold_start_breakdown
+ *   - arkanalyzer_find_references / arkanalyzer_list_components
+ *   - arkcheck_lint_project / arkcheck_list_rules
+ *   - knowledge_search_kb / knowledge_read_doc
+ */
+export {};

package/dist/src/index.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+/**
+ * harmony-build MCP Server 入口
+ *
+ * 把 7 个独立的 harmony-* MCP server（hdc / hvigor / profiler /
+ * arkanalyzer / arkcheck / knowledge / dev）合并成 1 个进程 + 1 个 stdio 连接。
+ *
+ * 工具名加 `<namespace>_` 前缀避免冲突，例如：
+ *   - hdc_list_devices / hdc_install_hap
+ *   - hvigor_build_hap / hvigor_clean
+ *   - dev_run_app / dev_start_log_stream
+ *   - profiler_capture_trace / profiler_cold_start_breakdown
+ *   - arkanalyzer_find_references / arkanalyzer_list_components
+ *   - arkcheck_lint_project / arkcheck_list_rules
+ *   - knowledge_search_kb / knowledge_read_doc
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { toolDefinitions } from "./server/tools.js";
+import { handleToolCall } from "./server/handlers.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// 兼容两种布局：
+//   1) 源码:  src/index.ts          → ../package.json
+//   2) 产物:  dist/src/index.js     → ../../package.json
+function loadVersion() {
+    for (const rel of ["../package.json", "../../package.json"]) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(__dirname, rel), "utf-8"));
+            if (pkg?.version)
+                return pkg.version;
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return "0.0.0";
+}
+const VERSION = loadVersion();
+const server = new Server({ name: "harmony-build", version: VERSION }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: toolDefinitions,
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    return handleToolCall(name, (args ?? {}));
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`[harmony-build] v${VERSION} started on stdio · ${toolDefinitions.length} tools`);
+}
+main().catch((error) => {
+    console.error("[harmony-build] Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,UAAU;AACV,oDAAoD;AACpD,uDAAuD;AACvD,SAAS,WAAW;IAClB,KAAK,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;YACpE,IAAI,GAAG,EAAE,OAAO;gBAAE,OAAO,GAAG,CAAC,OAAiB,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,MAAM,OAAO,GAAW,WAAW,EAAE,CAAC;AAEtC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,EAAE,EAC3C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE,eAAe;CACvB,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,OAAO,cAAc,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;AACvE,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CACX,oBAAoB,OAAO,uBAAuB,eAAe,CAAC,MAAM,QAAQ,CACjF,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;IACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/src/server/handlers.d.ts

@@ -0,0 +1,11 @@
+/**
+ * harmony-build MCP 工具调度
+ *
+ * 把请求按工具名转发给对应子包的 handler，并按 MCP 协议返回 text content。
+ */
+export declare function handleToolCall(name: string, args: Record<string, unknown>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/src/server/handlers.js

@@ -0,0 +1,33 @@
+/**
+ * harmony-build MCP 工具调度
+ *
+ * 把请求按工具名转发给对应子包的 handler，并按 MCP 协议返回 text content。
+ */
+import { toolMap } from "./tools.js";
+import { toErrorPayload } from "../../packages/mcp-common/src/errors.js";
+function ok(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}
+function fail(payload) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+    };
+}
+export async function handleToolCall(name, args) {
+    const tool = toolMap.get(name);
+    if (!tool) {
+        return fail({ code: "UNKNOWN_TOOL", message: `unknown tool: ${name}` });
+    }
+    try {
+        const parsed = tool.schema.parse(args ?? {});
+        const data = await tool.handler(parsed);
+        return ok(data);
+    }
+    catch (err) {
+        return fail(toErrorPayload(err));
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/src/server/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../src/server/handlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAEzE,SAAS,EAAE,CAAC,IAAa;IACvB,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,OAA6D;IACzE,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,IAA6B;IAE7B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/src/server/tools.d.ts

@@ -0,0 +1,23 @@
+/**
+ * harmony-build 聚合 MCP 工具定义
+ *
+ * 复用 7 个子包导出的 tools 数组（hdc / hvigor / profiler / arkanalyzer /
+ * arkcheck / knowledge / dev），每个工具名加 `<namespace>_` 前缀避免冲突。
+ *
+ * 工具实现 100% 来自子包，零代码重复。
+ */
+import { z } from "zod";
+import type { ToolDef } from "../../packages/mcp-common/src/index.js";
+/**
+ * 聚合所有子包工具，加 namespace 前缀，避免重名。
+ * 返回带 zod schema 的 ToolDef 数组，供 handler 使用。
+ */
+export declare function buildAggregatedTools(): ToolDef<z.ZodObject<z.ZodRawShape>>[];
+/** 仅供 MCP ListTools 用的精简版（含 JSON Schema）。 */
+export declare const toolDefinitions: {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}[];
+/** 给 handlers 使用的全名 → ToolDef 映射。 */
+export declare const toolMap: Map<string, ToolDef<z.ZodObject<z.ZodRawShape>>>;

package/dist/src/server/tools.js

@@ -0,0 +1,57 @@
+/**
+ * harmony-build 聚合 MCP 工具定义
+ *
+ * 复用 7 个子包导出的 tools 数组（hdc / hvigor / profiler / arkanalyzer /
+ * arkcheck / knowledge / dev），每个工具名加 `<namespace>_` 前缀避免冲突。
+ *
+ * 工具实现 100% 来自子包，零代码重复。
+ */
+import * as hdc from "../../packages/hdc-mcp/src/index.js";
+import * as hvigor from "../../packages/hvigor-mcp/src/index.js";
+import * as profiler from "../../packages/profiler-mcp/src/index.js";
+import * as arkanalyzer from "../../packages/arkanalyzer-mcp/src/index.js";
+import * as arkcheck from "../../packages/arkcheck-mcp/src/index.js";
+import * as knowledge from "../../packages/harmony-knowledge-mcp/src/index.js";
+import * as dev from "../../packages/dev-mcp/src/index.js";
+import { zodToJsonSchema } from "../../packages/mcp-common/src/mcp-helpers.js";
+const SUBS = [
+    hdc,
+    hvigor,
+    profiler,
+    arkanalyzer,
+    arkcheck,
+    knowledge,
+    dev,
+];
+/**
+ * 聚合所有子包工具，加 namespace 前缀，避免重名。
+ * 返回带 zod schema 的 ToolDef 数组，供 handler 使用。
+ */
+export function buildAggregatedTools() {
+    const aggregated = [];
+    const seen = new Set();
+    for (const sub of SUBS) {
+        for (const t of sub.tools) {
+            const name = `${sub.NAMESPACE}_${t.name}`;
+            if (seen.has(name))
+                continue;
+            seen.add(name);
+            aggregated.push({
+                name,
+                description: `[${sub.NAMESPACE}] ${t.description}`,
+                schema: t.schema,
+                handler: t.handler,
+            });
+        }
+    }
+    return aggregated;
+}
+/** 仅供 MCP ListTools 用的精简版（含 JSON Schema）。 */
+export const toolDefinitions = buildAggregatedTools().map((t) => ({
+    name: t.name,
+    description: t.description,
+    inputSchema: zodToJsonSchema(t.schema),
+}));
+/** 给 handlers 使用的全名 → ToolDef 映射。 */
+export const toolMap = new Map(buildAggregatedTools().map((t) => [t.name, t]));
+//# sourceMappingURL=tools.js.map

package/dist/src/server/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/server/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,GAAG,MAAM,qCAAqC,CAAC;AAC3D,OAAO,KAAK,MAAM,MAAM,wCAAwC,CAAC;AACjE,OAAO,KAAK,QAAQ,MAAM,0CAA0C,CAAC;AACrE,OAAO,KAAK,WAAW,MAAM,6CAA6C,CAAC;AAC3E,OAAO,KAAK,QAAQ,MAAM,0CAA0C,CAAC;AACrE,OAAO,KAAK,SAAS,MAAM,mDAAmD,CAAC;AAC/E,OAAO,KAAK,GAAG,MAAM,qCAAqC,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAO/E,MAAM,IAAI,GAAiB;IACzB,GAA4B;IAC5B,MAA+B;IAC/B,QAAiC;IACjC,WAAoC;IACpC,QAAiC;IACjC,SAAkC;IAClC,GAA4B;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,UAAU,GAA0C,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACf,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI;gBACJ,WAAW,EAAE,IAAI,GAAG,CAAC,SAAS,KAAK,CAAC,CAAC,WAAW,EAAE;gBAClD,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,6CAA6C;AAC7C,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChE,IAAI,EAAE,CAAC,CAAC,IAAI;IACZ,WAAW,EAAE,CAAC,CAAC,WAAW;IAC1B,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC;CACvC,CAAC,CAAC,CAAC;AAEJ,qCAAqC;AACrC,MAAM,CAAC,MAAM,OAAO,GAAqD,IAAI,GAAG,CAC9E,oBAAoB,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC/C,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "harmony-build",
+  "version": "0.2.0",
+  "description": "HarmonyOS Toolchain MCP Server (all-in-one) - 30+ tools across hdc / hvigor / profiler / arkanalyzer / arkcheck / knowledge / dev",
+  "type": "module",
+  "bin": {
+    "harmony-build": "./dist/src/index.js",
+    "harmony-build-mcp": "./dist/src/index.js"
+  },
+  "main": "dist/src/index.js",
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "发布指南.md"
+  ],
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:workspaces": "npm run build -w @harmony-mcp/common && npm run build --workspaces --if-present --include-workspace-root=false",
+    "clean": "rm -rf dist && npm run clean --workspaces --if-present",
+    "demo": "node demo/run-demo.mjs",
+    "install:joycode": "node scripts/install-joycode.mjs",
+    "prepublishOnly": "npm run clean && npm run build",
+    "start": "node dist/src/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "harmonyos",
+    "arkts",
+    "ai-agent",
+    "hdc",
+    "hvigor",
+    "profiler",
+    "deveco"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package//345/217/221/345/270/203/346/214/207/345/215/227.md

@@ -0,0 +1,45 @@
+---
+inclusion: manual
+---
+
+# bmall-mcp 发布流程
+
+## 发布步骤
+
+1. **更新版本号**
+   - 修改 `package.json` 中的 `version` 字段
+   - 版本号规则：`major.minor.patch`（如 1.4.3）
+
+2. **更新 Changelog**
+   - 在 `README.md` 的 Changelog 部分最上方添加新版本记录
+   - 格式：`### vX.X.X (YYYY-MM-DD)`
+   - 列出本次更新的功能/修复（使用 ✅ 标记）
+
+3. **构建项目**
+   ```bash
+   npm run build
+   ```
+
+4. **提交代码**
+   ```bash
+   git add -A
+   git commit -m "chore: 发布 vX.X.X"
+   git push
+   ```
+
+5. **发布到 npm**
+   ```bash
+   npm publish --registry https://registry.npmjs.org/
+   ```
+
+## 版本号规则
+
+- **patch** (x.x.1): 修复 bug、小优化
+- **minor** (x.1.0): 新增功能、向后兼容
+- **major** (1.0.0): 破坏性变更
+
+## 注意事项
+
+- 发布前确保所有改动已测试
+- Changelog 描述要清晰简洁
+- 必须使用官方源发布：`--registry https://registry.npmjs.org/`