@visualization-hub/dev-mcp 1.0.0

package/README.md

@@ -0,0 +1,93 @@
+<!--
+ * @Author: Roman 306863030@qq.com
+ * @Date: 2026-09-01 11:14:16
+ * @LastEditors: Roman 306863030@qq.com
+ * @LastEditTime: 2026-09-01 11:38:22
+ * @FilePath: \visualization-project-knowledge-base\dev-mcp\README.md
+ * @Description: 这是默认设置,请设置`customMade`, 打开koroFileHeader查看配置 进行设置: https://github.com/OBKoro1/koro1FileHeader/wiki/%E9%85%8D%E7%BD%AE
+-->
+# Visualization Hub Developer MCP Toolkit (`@visualization-hub/dev-mcp`)
+
+> **低空前端组件资产知识库 — 开发者 MCP 工具链**  
+> 面向 AI Agent（Cursor、Claude Desktop、VS Code、Deepfish）与前端工程师的本地全生命周期组件研发工作站。
+
+---
+
+## 🌟 核心特性
+
+- 🚀 **极速物理直传**：本地一键打包 ZIP 并通过底层 HTTP Multipart 流式推送平台，耗时 **< 0.1 秒**，Token 消耗趋近于 **0**。
+- 🛠️ **完整工程脚手架**：一键生成 Vue 3 + TypeScript + Less + Vite 标准多文件工程，默认满足平台 13 项沙箱合规规范。
+- 📦 **本地 Vite 构建**：在本地直接执行编译打包，输出沙箱专属的 `dist/index.js` 与 `dist/index.css`，直接捕获 TypeScript 与语法错误。
+- 🛡️ **13 项合规静态扫描**：自动化代码扫描（检查 `pointer-events: auto !important`、杜绝 emoji、`onUnmounted` 资源销毁等），提供精准代码行号与修复建议。
+- 🧭 **全流程智能引导**：内置 `get_developer_guide` 导航工具，支持分阶段按需下发研发步骤与输入范例。
+- 🔍 **云端全量检索代理**：100% 具备知识库资产搜索、分类统计、文件树查询、单文件源码读取与全局正则 grep 检索能力。
+
+
+---
+
+## ⚙️ 环境变量配置 (`Environment Variables`)
+
+开发者 MCP 在启动时自动读取环境变量或当前目录下的 `.env` 文件。优先级为：**工具入参 > 环境变量 > 默认兜底值**。
+
+| 环境变量名 (`Env Name`) | 别名 (`Alias`) | 是否必需 | 默认值 | 详细说明 |
+| :--- | :--- | :---: | :---: | :--- |
+| **`VIZ_BASE_URL`** | `BASE_URL` | 否 | `http://localhost:3000` | 知识库云端平台的后端服务地址（支持本地、局域网或公网地址） |
+| **`VIZ_API_KEY`** | `API_KEY` | **是**（写操作） | 空 | 开发者 API Key（可在知识库平台个人中心生成，如 `ak_live_xxx`） |
+| **`VIZ_TIMEOUT_MS`** | `TIMEOUT_MS` | 否 | `30000` | HTTP 请求与物理上传超时时间（毫秒）。**设置为 `-1` 表示无限制（不超时）** |
+
+> **工作区目录规范**：无需配置环境变量，工作区目录**默认为当前命令的执行目录 (`process.cwd()`)**；各工具亦支持通过参数（如 `targetDir` / `projectDir`）显式指定自定义路径。
+
+---
+
+## 💻 主流 AI Agent 客户端接入配置
+
+### 1. Claude Desktop (`claude_desktop_config.json`)
+```json
+{
+  "mcpServers": {
+    "visualization-dev-mcp": {
+      "command": "npx",
+      "args": ["-y", "@visualization-hub/dev-mcp"],
+      "env": {
+        "VIZ_BASE_URL": "http://localhost:3000",
+        "VIZ_API_KEY": "ak_live_xxxxxxxxxxxxxxxxxxxx",
+        "VIZ_TIMEOUT_MS": "-1"
+      }
+    }
+  }
+}
+```
+
+### 2. Cursor (`.cursor/mcp.json`)
+```json
+{
+  "mcpServers": {
+    "visualization-dev-mcp": {
+      "command": "node",
+      "args": ["D:/.../dev-mcp/dist/index.js"],
+      "env": {
+        "VIZ_BASE_URL": "http://localhost:3000",
+        "VIZ_API_KEY": "ak_live_xxxxxxxxxxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+### 3. VS Code (Roo Code / Cline MCP Settings)
+```json
+{
+  "mcpServers": {
+    "viz-dev": {
+      "command": "npx",
+      "args": ["@visualization-hub/dev-mcp"],
+      "env": {
+        "VIZ_BASE_URL": "http://localhost:3000",
+        "VIZ_API_KEY": "ak_live_xxxxxxxxxxxxxxxxxxxx",
+        "VIZ_TIMEOUT_MS": "60000"
+      }
+    }
+  }
+}
+```
+

package/bin/viz-dev-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/index.js');

package/dist/client/discovery-api.d.ts

@@ -0,0 +1,17 @@
+import { IDevMcpConfig } from '../config';
+export interface ISearchProjectsParams {
+    keywords?: string[] | string;
+    page_type?: string;
+    category?: string;
+    page?: number;
+    page_size?: number;
+    keyword?: string;
+}
+export declare function searchProjects(params: ISearchProjectsParams, configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+export declare function listCategories(configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+export declare function getProjectDetail(projectName: string, configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+export declare function listMyProjects(params?: {
+    page?: number;
+    page_size?: number;
+}, configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+//# sourceMappingURL=discovery-api.d.ts.map

package/dist/client/discovery-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-api.d.ts","sourceRoot":"","sources":["../../src/client/discovery-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,qBAAqB,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAoB3G;AAED,wBAAsB,cAAc,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAI5E;AAED,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAInG;AAED,wBAAsB,cAAc,CAAC,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAS5H"}

package/dist/client/discovery-api.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchProjects = searchProjects;
+exports.listCategories = listCategories;
+exports.getProjectDetail = getProjectDetail;
+exports.listMyProjects = listMyProjects;
+const http_1 = require("./http");
+async function searchProjects(params, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const queryParams = {
+        page: params.page || 1,
+        page_size: params.page_size || 20
+    };
+    if (params.page_type || params.category) {
+        queryParams.page_type = params.page_type || params.category;
+    }
+    if (params.keywords) {
+        const kw = Array.isArray(params.keywords) ? params.keywords.join(' ') : params.keywords;
+        queryParams.keyword = kw;
+    }
+    else if (params.keyword) {
+        queryParams.keyword = params.keyword;
+    }
+    const res = await http.get('/api/projects', { params: queryParams });
+    return res.data?.data || res.data;
+}
+async function listCategories(configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const res = await http.get('/api/categories');
+    return res.data?.data || res.data;
+}
+async function getProjectDetail(projectName, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const res = await http.get(`/api/projects/${encodeURIComponent(projectName)}`);
+    return res.data?.data || res.data;
+}
+async function listMyProjects(params, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const res = await http.get('/api/projects/my', {
+        params: {
+            page: params?.page || 1,
+            page_size: params?.page_size || 20
+        }
+    });
+    return res.data?.data || res.data;
+}
+//# sourceMappingURL=discovery-api.js.map

package/dist/client/discovery-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-api.js","sourceRoot":"","sources":["../../src/client/discovery-api.ts"],"names":[],"mappings":";;AAYA,wCAoBC;AAED,wCAIC;AAED,4CAIC;AAED,wCASC;AAvDD,iCAA0C;AAYnC,KAAK,UAAU,cAAc,CAAC,MAA6B,EAAE,eAAwC;IAC1G,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAwB;QACvC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;KAClC,CAAC;IAEF,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxC,WAAW,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC;IAC9D,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACxF,WAAW,CAAC,OAAO,GAAG,EAAE,CAAC;IAC3B,CAAC;SAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1B,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IACvC,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACrE,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,eAAwC;IAC3E,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,eAAwC;IAClG,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC/E,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,MAA8C,EAAE,eAAwC;IAC3H,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE;QAC7C,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC;YACvB,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,EAAE;SACnC;KACF,CAAC,CAAC;IACH,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC"}

package/dist/client/environment-api.d.ts

@@ -0,0 +1,3 @@
+import { IDevMcpConfig } from '../config';
+export declare function getGlobalPackages(pageType?: string, configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+//# sourceMappingURL=environment-api.d.ts.map

package/dist/client/environment-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-api.d.ts","sourceRoot":"","sources":["../../src/client/environment-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,wBAAsB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAMlG"}

package/dist/client/environment-api.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGlobalPackages = getGlobalPackages;
+const http_1 = require("./http");
+async function getGlobalPackages(pageType, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const params = {};
+    if (pageType)
+        params.page_type = pageType;
+    const res = await http.get('/api/packages', { params });
+    return res.data?.data || res.data;
+}
+//# sourceMappingURL=environment-api.js.map

package/dist/client/environment-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-api.js","sourceRoot":"","sources":["../../src/client/environment-api.ts"],"names":[],"mappings":";;AAGA,8CAMC;AATD,iCAA0C;AAGnC,KAAK,UAAU,iBAAiB,CAAC,QAAiB,EAAE,eAAwC;IACjG,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,QAAQ;QAAE,MAAM,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACxD,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC"}

package/dist/client/http.d.ts

@@ -0,0 +1,7 @@
+import { AxiosInstance } from 'axios';
+import { IDevMcpConfig } from '../config';
+/**
+ * 创建与知识库平台通信的 Axios 统一实例
+ */
+export declare function createHttpClient(configOverrides?: Partial<IDevMcpConfig>): AxiosInstance;
+//# sourceMappingURL=http.d.ts.map

package/dist/client/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/client/http.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAa,aAAa,EAAE,MAAM,WAAW,CAAC;AAErD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAiCxF"}

package/dist/client/http.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createHttpClient = createHttpClient;
+const axios_1 = __importDefault(require("axios"));
+const config_1 = require("../config");
+/**
+ * 创建与知识库平台通信的 Axios 统一实例
+ */
+function createHttpClient(configOverrides) {
+    const config = (0, config_1.getConfig)(configOverrides);
+    const headers = {
+        Accept: 'application/json'
+    };
+    if (config.apiKey) {
+        headers['Authorization'] = `Bearer ${config.apiKey}`;
+        headers['x-api-key'] = config.apiKey;
+    }
+    // Axios 中 timeout: 0 表示不限制超时 (对应配置的 -1)
+    const timeout = config.timeoutMs === -1 ? 0 : config.timeoutMs;
+    const instance = axios_1.default.create({
+        baseURL: config.baseUrl,
+        timeout,
+        headers
+    });
+    instance.interceptors.response.use((res) => res, (err) => {
+        const respData = err.response?.data;
+        const msg = respData?.message || respData?.error || err.message || '网络请求失败';
+        const status = err.response?.status;
+        const customErr = new Error(`[API 请求失败 ${status ? 'HTTP ' + status : ''}] ${msg}`);
+        customErr.response = err.response;
+        return Promise.reject(customErr);
+    });
+    return instance;
+}
+//# sourceMappingURL=http.js.map

package/dist/client/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/client/http.ts"],"names":[],"mappings":";;;;;AAMA,4CAiCC;AAvCD,kDAA6C;AAC7C,sCAAqD;AAErD;;GAEG;AACH,SAAgB,gBAAgB,CAAC,eAAwC;IACvE,MAAM,MAAM,GAAG,IAAA,kBAAS,EAAC,eAAe,CAAC,CAAC;IAC1C,MAAM,OAAO,GAA2B;QACtC,MAAM,EAAE,kBAAkB;KAC3B,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC;QACrD,OAAO,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACvC,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;IAE/D,MAAM,QAAQ,GAAG,eAAK,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO;QACP,OAAO;KACR,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAChC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EACZ,CAAC,GAAG,EAAE,EAAE;QACN,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC;QACpC,MAAM,GAAG,GAAG,QAAQ,EAAE,OAAO,IAAI,QAAQ,EAAE,KAAK,IAAI,GAAG,CAAC,OAAO,IAAI,QAAQ,CAAC;QAC5E,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,aAAa,MAAM,CAAC,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;QAClF,SAAiB,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;QAC3C,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC,CACF,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/client/inspection-api.d.ts

@@ -0,0 +1,9 @@
+import { IDevMcpConfig } from '../config';
+export declare function getProjectFiles(projectName: string, version?: string, configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+export declare function getFileContent(projectName: string, filePath: string, version?: string, configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+export declare function grepSourceCode(params: {
+    query: string;
+    project_name?: string;
+    file_pattern?: string;
+}, configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+//# sourceMappingURL=inspection-api.d.ts.map

package/dist/client/inspection-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-api.d.ts","sourceRoot":"","sources":["../../src/client/inspection-api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAMpH;AAED,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAQrI;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAIrJ"}

package/dist/client/inspection-api.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectFiles = getProjectFiles;
+exports.getFileContent = getFileContent;
+exports.grepSourceCode = grepSourceCode;
+const http_1 = require("./http");
+async function getProjectFiles(projectName, version, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const params = {};
+    if (version)
+        params.version = version;
+    const res = await http.get(`/api/projects/${encodeURIComponent(projectName)}/files`, { params });
+    return res.data?.data || res.data;
+}
+async function getFileContent(projectName, filePath, version, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const params = {
+        path: filePath
+    };
+    if (version)
+        params.version = version;
+    const res = await http.get(`/api/projects/${encodeURIComponent(projectName)}/content`, { params });
+    return res.data?.data || res.data;
+}
+async function grepSourceCode(params, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const res = await http.get('/api/projects/grep', { params });
+    return res.data?.data || res.data;
+}
+//# sourceMappingURL=inspection-api.js.map

package/dist/client/inspection-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspection-api.js","sourceRoot":"","sources":["../../src/client/inspection-api.ts"],"names":[],"mappings":";;AAGA,0CAMC;AAED,wCAQC;AAED,wCAIC;AAzBD,iCAA0C;AAGnC,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,OAAgB,EAAE,eAAwC;IACnH,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACjG,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,WAAmB,EAAE,QAAgB,EAAE,OAAgB,EAAE,eAAwC;IACpI,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,MAAM,GAA2B;QACrC,IAAI,EAAE,QAAQ;KACf,CAAC;IACF,IAAI,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACnG,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,MAAuE,EAAE,eAAwC;IACpJ,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC"}

package/dist/client/transfer-api.d.ts

@@ -0,0 +1,10 @@
+import { IDevMcpConfig } from '../config';
+export interface IUploadZipParams {
+    zipBuffer: Buffer;
+    changelog?: string;
+    upload_project_type?: 'test' | 'final';
+}
+export declare function uploadProjectZip(params: IUploadZipParams, configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+export declare function downloadProjectZip(projectName: string, version?: string, configOverrides?: Partial<IDevMcpConfig>): Promise<Buffer>;
+export declare function deleteProjectVersion(projectName: string, version: string, configOverrides?: Partial<IDevMcpConfig>): Promise<any>;
+//# sourceMappingURL=transfer-api.d.ts.map

package/dist/client/transfer-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-api.d.ts","sourceRoot":"","sources":["../../src/client/transfer-api.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAwBxG;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAWzI;AAED,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,gBAIxH"}

package/dist/client/transfer-api.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadProjectZip = uploadProjectZip;
+exports.downloadProjectZip = downloadProjectZip;
+exports.deleteProjectVersion = deleteProjectVersion;
+const form_data_1 = __importDefault(require("form-data"));
+const http_1 = require("./http");
+async function uploadProjectZip(params, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const formData = new form_data_1.default();
+    formData.append('file', params.zipBuffer, {
+        filename: 'project.zip',
+        contentType: 'application/zip'
+    });
+    if (params.changelog) {
+        formData.append('changelog', params.changelog);
+    }
+    if (params.upload_project_type) {
+        formData.append('upload_project_type', params.upload_project_type);
+    }
+    const res = await http.post('/api/projects/upload-zip', formData, {
+        headers: {
+            ...formData.getHeaders()
+        },
+        maxBodyLength: Infinity,
+        maxContentLength: Infinity
+    });
+    return res.data?.data || res.data;
+}
+async function downloadProjectZip(projectName, version, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const params = {};
+    if (version)
+        params.version = version;
+    const res = await http.get(`/api/projects/${encodeURIComponent(projectName)}/download`, {
+        params,
+        responseType: 'arraybuffer'
+    });
+    return Buffer.from(res.data);
+}
+async function deleteProjectVersion(projectName, version, configOverrides) {
+    const http = (0, http_1.createHttpClient)(configOverrides);
+    const res = await http.delete(`/api/projects/${encodeURIComponent(projectName)}/versions/${encodeURIComponent(version)}`);
+    return res.data?.data || res.data;
+}
+//# sourceMappingURL=transfer-api.js.map

package/dist/client/transfer-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-api.js","sourceRoot":"","sources":["../../src/client/transfer-api.ts"],"names":[],"mappings":";;;;;AAUA,4CAwBC;AAED,gDAWC;AAED,oDAIC;AArDD,0DAAiC;AACjC,iCAA0C;AASnC,KAAK,UAAU,gBAAgB,CAAC,MAAwB,EAAE,eAAwC;IACvG,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,mBAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,EAAE;QACxC,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,iBAAiB;KAC/B,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC/B,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,0BAA0B,EAAE,QAAQ,EAAE;QAChE,OAAO,EAAE;YACP,GAAG,QAAQ,CAAC,UAAU,EAAE;SACzB;QACD,aAAa,EAAE,QAAQ;QACvB,gBAAgB,EAAE,QAAQ;KAC3B,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,WAAmB,EAAE,OAAgB,EAAE,eAAwC;IACtH,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,OAAO;QAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IAEtC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,WAAW,EAAE;QACtF,MAAM;QACN,YAAY,EAAE,aAAa;KAC5B,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAEM,KAAK,UAAU,oBAAoB,CAAC,WAAmB,EAAE,OAAe,EAAE,eAAwC;IACvH,MAAM,IAAI,GAAG,IAAA,uBAAgB,EAAC,eAAe,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,kBAAkB,CAAC,WAAW,CAAC,aAAa,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1H,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;AACpC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+export interface IDevMcpConfig {
+    baseUrl: string;
+    apiKey: string;
+    timeoutMs: number;
+    workspaceDir: string;
+}
+/**
+ * 获取开发者 MCP 运行配置
+ * 优先级: 显式参数 > 环境变量 > 默认值
+ */
+export declare function getConfig(overrides?: Partial<IDevMcpConfig>): IDevMcpConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAkC3E"}

package/dist/config.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = getConfig;
+const dotenv_1 = __importDefault(require("dotenv"));
+const path_1 = __importDefault(require("path"));
+// 加载当前执行目录及项目目录下的 .env
+dotenv_1.default.config();
+try {
+    dotenv_1.default.config({ path: path_1.default.resolve(process.cwd(), '.env') });
+}
+catch (e) { }
+/**
+ * 获取开发者 MCP 运行配置
+ * 优先级: 显式参数 > 环境变量 > 默认值
+ */
+function getConfig(overrides) {
+    const baseUrl = overrides?.baseUrl ||
+        process.env.VIZ_BASE_URL ||
+        process.env.BASE_URL ||
+        'http://localhost:3000';
+    const apiKey = overrides?.apiKey ||
+        process.env.VIZ_API_KEY ||
+        process.env.API_KEY ||
+        '';
+    const rawTimeout = overrides?.timeoutMs !== undefined
+        ? String(overrides.timeoutMs)
+        : process.env.VIZ_TIMEOUT_MS || process.env.TIMEOUT_MS || '30000';
+    let timeoutMs = parseInt(rawTimeout, 10);
+    if (isNaN(timeoutMs)) {
+        timeoutMs = 30000;
+    }
+    const workspaceDir = overrides?.workspaceDir ||
+        process.env.VIZ_WORKSPACE_DIR ||
+        process.env.WORKSPACE_DIR ||
+        process.cwd();
+    return {
+        baseUrl: baseUrl.replace(/\/+$/, ''),
+        apiKey,
+        timeoutMs,
+        workspaceDir: path_1.default.resolve(workspaceDir)
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;AAoBA,8BAkCC;AAtDD,oDAA4B;AAC5B,gDAAwB;AAExB,uBAAuB;AACvB,gBAAM,CAAC,MAAM,EAAE,CAAC;AAChB,IAAI,CAAC;IACH,gBAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC;AAAC,OAAO,CAAC,EAAE,CAAC,CAAA,CAAC;AASd;;;GAGG;AACH,SAAgB,SAAS,CAAC,SAAkC;IAC1D,MAAM,OAAO,GACX,SAAS,EAAE,OAAO;QAClB,OAAO,CAAC,GAAG,CAAC,YAAY;QACxB,OAAO,CAAC,GAAG,CAAC,QAAQ;QACpB,uBAAuB,CAAC;IAE1B,MAAM,MAAM,GACV,SAAS,EAAE,MAAM;QACjB,OAAO,CAAC,GAAG,CAAC,WAAW;QACvB,OAAO,CAAC,GAAG,CAAC,OAAO;QACnB,EAAE,CAAC;IAEL,MAAM,UAAU,GAAG,SAAS,EAAE,SAAS,KAAK,SAAS;QACnD,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;QAC7B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC;IAEpE,IAAI,SAAS,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACrB,SAAS,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,MAAM,YAAY,GAChB,SAAS,EAAE,YAAY;QACvB,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC7B,OAAO,CAAC,GAAG,CAAC,aAAa;QACzB,OAAO,CAAC,GAAG,EAAE,CAAC;IAEhB,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,MAAM;QACN,SAAS;QACT,YAAY,EAAE,cAAI,CAAC,OAAO,CAAC,YAAY,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}