@uni-helper/mcp 0.0.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-PRESENT FliPPeDround <https://github.com/FliPPeDround>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# [WIP]uniapp MCP plugin
+
+## 安装
+
+```bash
+pnpm add @uni-helper/mcp -D
+```
+
+## 配置
+
+在 `vite.config.ts` 中添加如下配置：
+
+```ts
+import { defineConfig } from 'vite'
+import uni from '@dcloudio/vite-plugin-uni'
+import mcp from '@uni-helper/mcp'
+
+export default defineConfig({
+  plugins: [uni(), mcp()],
+})
+```
+
+

package/dist/index.d.mts

@@ -0,0 +1,79 @@
+import { Plugin } from "vite";
+
+//#region node_modules/.pnpm/@langchain+core@1.1.15_openai@6.16.0_ws@8.19.0_zod@4.3.5_/node_modules/@langchain/core/dist/embeddings.d.cts
+interface EmbeddingsInterface<TOutput = number[]> {
+  /**
+     * An abstract method that takes an array of documents as input and
+     * returns a promise that resolves to an array of vectors for each
+     * document.
+     * @param documents An array of documents to be embedded.
+     * @returns A promise that resolves to an array of vectors for each document.
+     */
+  embedDocuments(documents: string[]): Promise<TOutput[]>;
+  /**
+     * An abstract method that takes a single document as input and returns a
+     * promise that resolves to a vector for the query document.
+     * @param document A single document to be embedded.
+     * @returns A promise that resolves to a vector for the query document.
+     */
+  embedQuery(document: string): Promise<TOutput>;
+}
+/**
+ * An abstract class that provides methods for embedding documents and
+ * queries using LangChain.
+ */
+//#endregion
+//#region src/types.d.ts
+type SupportedUpdateConfigType = 'cursor' | 'vscode' | 'windsurf' | 'claude-code' | 'trae-cn' | 'trae';
+type MaybeArray<T> = T | T[];
+interface UniMcpOptions {
+  /**
+       * 监听的端口，默认为 Vite 开发服务器的端口
+       */
+  port?: number;
+  /**
+       * 在控制台打印 MCP 服务器 URL
+       *
+       * @default true
+       */
+  printUrl?: boolean;
+  /**
+       * 自定义的 Embeddings 模型
+       *
+       * 内置模型为 Qwen3-Embedding-0.6B-ONNX
+       *
+       * 如果本地运行效率低，可自定义模型
+       * - 确保模型支持 1024 维
+       * - 支持 langchain 的 Embeddings 格式
+       * @default
+       * ```ts
+       * new HuggingFaceTransformersEmbeddings({
+       *   model: 'onnx-community/Qwen3-Embedding-0.6B-ONNX',
+       *   pretrainedOptions: {
+       *     dtype: 'int8',
+       *     device: 'cpu',
+       *   },
+       * })
+       * ```
+       */
+  embeddings?: EmbeddingsInterface;
+  /**
+       * 要更新的配置类型
+       *
+       * - `auto` - 如果配置文件存在则自动更新
+       * - `cursor` - 更新 Cursor 配置文件 `.cursor/mcp.json`
+       * - `vscode` - 更新 VSCode 配置文件 `.vscode/settings.json`
+       * - `windsurf` - 更新 Windsurf 配置文件 `~/.codeium/windsurf/mcp_config.json`
+       * - `claude-code` - 更新 Claude Code 配置文件 `.mcp.json`
+       * - `trae-cn` - 更新 Trae 配置文件 `~/trae CN/mcp.json`
+       * - `trae` - 更新 Trae 配置文件 `.trae/mcp.json`
+       *
+       * @default false
+       */
+  updateConfig?: 'auto' | false | MaybeArray<SupportedUpdateConfigType>;
+}
+//#endregion
+//#region src/index.d.ts
+declare function uniMcp(options?: UniMcpOptions): Plugin;
+//#endregion
+export { uniMcp as default };

package/dist/index.mjs

@@ -0,0 +1,411 @@
+import { searchForWorkspaceRoot } from "vite";
+import { serve } from "@hono/node-server";
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { env } from "@huggingface/transformers";
+import { HuggingFaceTransformersEmbeddings } from "@langchain/community/embeddings/huggingface_transformers";
+import { HNSWLib } from "@langchain/community/vectorstores/hnswlib";
+import fs from "fs-extra";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import consola from "consola";
+import { Buffer as Buffer$1 } from "node:buffer";
+import open from "open";
+
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJSMin = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+//#region node_modules/.pnpm/ansis@4.2.0/node_modules/ansis/index.cjs
+var require_ansis = /* @__PURE__ */ __commonJSMin(((exports, module) => {
+	let e, t, r, { defineProperty: l, setPrototypeOf: n, create: o, keys: s } = Object, i = "", { round: c, max: a } = Math, p = (e) => {
+		let t = /([a-f\d]{3,6})/i.exec(e)?.[1], r = t?.length, l = parseInt(6 ^ r ? 3 ^ r ? "0" : t[0] + t[0] + t[1] + t[1] + t[2] + t[2] : t, 16);
+		return [
+			l >> 16 & 255,
+			l >> 8 & 255,
+			255 & l
+		];
+	}, u = (e, t, r) => e ^ t || t ^ r ? 16 + 36 * c(e / 51) + 6 * c(t / 51) + c(r / 51) : 8 > e ? 16 : e > 248 ? 231 : c(24 * (e - 8) / 247) + 232, d = (e) => {
+		let t, r, l, n, o;
+		return 8 > e ? 30 + e : 16 > e ? e - 8 + 90 : (232 > e ? (o = (e -= 16) % 36, t = (e / 36 | 0) / 5, r = (o / 6 | 0) / 5, l = o % 6 / 5) : t = r = l = (10 * (e - 232) + 8) / 255, n = 2 * a(t, r, l), n ? 30 + (c(l) << 2 | c(r) << 1 | c(t)) + (2 ^ n ? 0 : 60) : 30);
+	}, f = (() => {
+		let r = (e) => o.some(((t) => e.test(t))), l = globalThis, n = l.process ?? {}, o = n.argv ?? [], i = n.env ?? {}, c = -1;
+		try {
+			e = "," + s(i).join(",");
+		} catch (e) {
+			i = {}, c = 0;
+		}
+		let a$1 = "FORCE_COLOR", p = {
+			false: 0,
+			0: 0,
+			1: 1,
+			2: 2,
+			3: 3
+		}[i[a$1]] ?? -1, u = a$1 in i && p || r(/^--color=?(true|always)?$/);
+		return u && (c = p), ~c || (c = ((r$1, l$1, n$1) => (t = r$1.TERM, {
+			"24bit": 3,
+			truecolor: 3,
+			ansi256: 2,
+			ansi: 1
+		}[r$1.COLORTERM] || (r$1.CI ? /,GITHUB/.test(e) ? 3 : 1 : l$1 && "dumb" !== t ? n$1 ? 3 : /-256/.test(t) ? 2 : 1 : 0)))(i, !!i.PM2_HOME || i.NEXT_RUNTIME?.includes("edge") || !!n.stdout?.isTTY, "win32" === n.platform)), !p || i.NO_COLOR || r(/^--(no-color|color=(false|never))$/) ? 0 : l.window?.chrome || u && !c ? 3 : c;
+	})(), g = {
+		open: i,
+		close: i
+	}, h = 39, b = 49, O = {}, m = ({ p: e }, { open: t, close: l }) => {
+		let o = (e$1, ...r) => {
+			if (!e$1) {
+				if (t && t === l) return t;
+				if ((e$1 ?? i) === i) return i;
+			}
+			let n, s$1 = e$1.raw ? String.raw({ raw: e$1 }, ...r) : i + e$1, c$1 = o.p, a$1 = c$1.o, p = c$1.c;
+			if (s$1.includes("\x1B")) for (; c$1; c$1 = c$1.p) {
+				let { open: e$2, close: t$1 } = c$1, r$1 = t$1.length, l$1 = i, o$1 = 0;
+				if (r$1) for (; ~(n = s$1.indexOf(t$1, o$1)); o$1 = n + r$1) l$1 += s$1.slice(o$1, n) + e$2;
+				s$1 = l$1 + s$1.slice(o$1);
+			}
+			return a$1 + (s$1.includes("\n") ? s$1.replace(/(\r?\n)/g, p + "$1" + a$1) : s$1) + p;
+		}, s = t, c = l;
+		return e && (s = e.o + t, c = l + e.c), n(o, r), o.p = {
+			open: t,
+			close: l,
+			o: s,
+			c,
+			p: e
+		}, o.open = s, o.close = c, o;
+	};
+	const w = new function e(t = f) {
+		let s = {
+			Ansis: e,
+			level: t,
+			isSupported: () => a$1,
+			strip: (e$1) => e$1.replace(/[›][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, i),
+			extend(e$1) {
+				for (let t$1 in e$1) {
+					let r = e$1[t$1], l = (typeof r)[0];
+					"s" === l ? (c(t$1, T(...p(r))), c(_(t$1), v(...p(r)))) : c(t$1, r, "f" === l);
+				}
+				return r = o({}, O), n(s, r), s;
+			}
+		}, c = (e$1, t$1, r) => {
+			O[e$1] = { get() {
+				let n = r ? (...e$2) => m(this, t$1(...e$2)) : m(this, t$1);
+				return l(this, e$1, { value: n }), n;
+			} };
+		}, a$1 = t > 0, w = (e$1, t$1) => a$1 ? {
+			open: `[${e$1}m`,
+			close: `[${t$1}m`
+		} : g, y = (e$1) => (t$1) => e$1(...p(t$1)), R = (e$1, t$1) => (r, l, n) => w(`${e$1}8;2;${r};${l};${n}`, t$1), $ = (e$1, t$1) => (r, l, n) => w(((e$2, t$2, r$1) => d(u(e$2, t$2, r$1)))(r, l, n) + e$1, t$1), x = (e$1) => (t$1, r, l) => e$1(u(t$1, r, l)), T = R(3, h), v = R(4, b), C = (e$1) => w("38;5;" + e$1, h), E = (e$1) => w("48;5;" + e$1, b);
+		2 === t ? (T = x(C), v = x(E)) : 1 === t && (T = $(0, h), v = $(10, b), C = (e$1) => w(d(e$1), h), E = (e$1) => w(d(e$1) + 10, b));
+		let M, I = {
+			fg: C,
+			bg: E,
+			rgb: T,
+			bgRgb: v,
+			hex: y(T),
+			bgHex: y(v),
+			visible: g,
+			reset: w(0, 0),
+			bold: w(1, 22),
+			dim: w(2, 22),
+			italic: w(3, 23),
+			underline: w(4, 24),
+			inverse: w(7, 27),
+			hidden: w(8, 28),
+			strikethrough: w(9, 29)
+		}, _ = (e$1) => "bg" + e$1[0].toUpperCase() + e$1.slice(1), k = "Bright";
+		return "black,red,green,yellow,blue,magenta,cyan,white,gray".split(",").map(((e$1, t$1) => {
+			M = _(e$1), 8 > t$1 ? (I[e$1 + k] = w(90 + t$1, h), I[M + k] = w(100 + t$1, b)) : t$1 = 60, I[e$1] = w(30 + t$1, h), I[M] = w(40 + t$1, b);
+		})), s.extend(I);
+	}();
+	module.exports = w, w.default = w;
+}));
+
+//#endregion
+//#region node_modules/.pnpm/ansis@4.2.0/node_modules/ansis/index.mjs
+var import_ansis = /* @__PURE__ */ __toESM(require_ansis(), 1);
+var ansis_default = import_ansis.default;
+const { Ansis, fg, bg, rgb, bgRgb, hex, bgHex, reset, inverse, hidden, visible, bold, dim, italic, underline, strikethrough, black, red, green, yellow, blue, magenta, cyan, white, gray, redBright, greenBright, yellowBright, blueBright, magentaBright, cyanBright, whiteBright, bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite, bgGray, bgRedBright, bgGreenBright, bgYellowBright, bgBlueBright, bgMagentaBright, bgCyanBright, bgWhiteBright } = import_ansis.default;
+
+//#endregion
+//#region src/mcpServer/connect.ts
+function connectServer(server, options) {
+	const { port = 2515, printUrl = true } = options;
+	const transport = new WebStandardStreamableHTTPServerTransport();
+	const app = new Hono();
+	app.use("*", cors({
+		origin: "*",
+		allowMethods: [
+			"GET",
+			"POST",
+			"DELETE",
+			"OPTIONS"
+		],
+		allowHeaders: [
+			"Content-Type",
+			"mcp-session-id",
+			"Last-Event-ID",
+			"mcp-protocol-version"
+		],
+		exposeHeaders: ["mcp-session-id", "mcp-protocol-version"]
+	}));
+	app.all("/mcp", (c) => transport.handleRequest(c.req.raw));
+	server.connect(transport).then(() => {
+		if (printUrl) console.log(`${ansis_default.cyan`  ➜ MCP:   `}${ansis_default.gray(`server is running at ${ansis_default.green(`http://localhost:${port}/mcp`)}`)}`);
+		serve({
+			fetch: app.fetch,
+			port
+		});
+	});
+	return `http://localhost:${port}/mcp`;
+}
+
+//#endregion
+//#region src/docs/index.ts
+const __dirname = dirname(fileURLToPath(import.meta.url));
+async function loadVectorStore(vectorName, _embeddings) {
+	const vectorDirMap = { uniapp: join(__dirname, "../", "vectorStore", "uniapp") };
+	env.remoteHost = "https://hf-mirror.com";
+	const embeddings = _embeddings ?? new HuggingFaceTransformersEmbeddings({
+		model: "onnx-community/Qwen3-Embedding-0.6B-ONNX",
+		pretrainedOptions: {
+			dtype: "int8",
+			device: "cpu"
+		}
+	});
+	return await HNSWLib.load(vectorDirMap[vectorName], embeddings);
+}
+
+//#endregion
+//#region package.json
+var version = "0.0.1";
+
+//#endregion
+//#region src/mcpServer/projectAnalyzer.ts
+async function readFileIfExists(path) {
+	const content = await fs.readFile(path, "utf-8").catch(() => void 0);
+	return {
+		exists: !!content,
+		path,
+		content
+	};
+}
+async function analyzeProject(rootPath) {
+	const [pagesJson, manifestJson] = await Promise.all([readFileIfExists(join(rootPath, "src/pages.json")), readFileIfExists(join(rootPath, "src/manifest.json"))]);
+	return {
+		pagesJson,
+		manifestJson
+	};
+}
+
+//#endregion
+//#region src/mcpServer/server.ts
+async function createMcpServer(config, options) {
+	const server = new McpServer({
+		name: "uni",
+		version
+	});
+	server.registerTool("get-vite-config", {
+		title: "获取 Vite 配置",
+		description: "获取 Vite 配置摘要，包括根目录、解析配置、插件和环境名称。"
+	}, () => ({ content: [{
+		type: "text",
+		text: JSON.stringify({
+			root: config.root,
+			resolve: config.resolve,
+			plugins: config.plugins.map((p) => p.name).filter(Boolean),
+			environmentNames: Object.keys(config.environments)
+		})
+	}] }));
+	server.registerTool("search-docs-by-Uniapp-official", {
+		title: "搜索 Uniapp 官方文档",
+		description: "在 Uniapp 文档知识库中进行搜索，可查找相关信息、代码示例、API参考文档和操作指南。当您需要解答关于Uniapp文档的问题、查找特定文档内容、了解功能运作原理或定位实现细节时，可使用此工具。搜索结果将返回带有标题的上下文相关内容，并附有直达文档页面的链接。",
+		inputSchema: { query: z.string().describe("用于搜索内容的查询语句") }
+	}, async ({ query }) => {
+		return { content: (await (await loadVectorStore("uniapp", options.embeddings)).similaritySearch(query, 3)).map((doc) => ({
+			type: "text",
+			text: JSON.stringify(doc)
+		})) };
+	});
+	server.registerTool("get-project-overview", {
+		title: "获取项目概览",
+		description: "返回 Uniapp 项目的 pages.json 和 manifest.json 配置文件。"
+	}, async () => {
+		const overview = await analyzeProject(config.root);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(overview, null, 2)
+		}] };
+	});
+	return server;
+}
+
+//#endregion
+//#region src/updateConfigs/claude.ts
+async function updateClaudeConfig(root, sseUrl, _options) {
+	const mcp = existsSync(join(root, ".mcp.json")) ? JSON.parse(await fs.readFile(join(root, ".mcp.json"), "utf-8") || "{}") : {};
+	mcp.mcpServers ||= {};
+	mcp.mcpServers.uni = {
+		type: "http",
+		url: sseUrl
+	};
+	await fs.writeFile(join(root, ".mcp.json"), `${JSON.stringify(mcp, null, 2)}\n`);
+	consola.log(`${CONSOLE_LOG_PREFIX}${ansis_default.gray(`Updated config file ${join(root, ".mcp.json")}`)}`);
+}
+
+//#endregion
+//#region src/updateConfigs/cursor.ts
+async function updateCursorConfig(root, sseUrl, _options) {
+	await fs.mkdir(join(root, ".cursor"), { recursive: true });
+	const mcp = existsSync(join(root, ".cursor/mcp.json")) ? JSON.parse(await fs.readFile(join(root, ".cursor/mcp.json"), "utf-8") || "{}") : {};
+	mcp.mcpServers ||= {};
+	mcp.mcpServers.uni = { url: sseUrl };
+	await fs.writeFile(join(root, ".cursor/mcp.json"), `${JSON.stringify(mcp, null, 2)}\n`);
+	consola.log(`${CONSOLE_LOG_PREFIX}${ansis_default.gray(`Updated config file ${join(root, ".cursor/mcp.json")}`)}`);
+}
+
+//#endregion
+//#region src/updateConfigs/print.ts
+function mcpServersConfig(sseUrl) {
+	const code = ansis_default.rgb(206, 145, 120);
+	const purple = ansis_default.rgb(218, 112, 214);
+	return `
+${ansis_default.yellow`{`}
+  ${code`"mcpServers"`}${ansis_default.white`:`} ${purple`{`}
+    ${code`"uni"`}${ansis_default.white`:`} ${ansis_default.blue`{`}
+      ${code`"url"`}${ansis_default.white`:`} ${code`"${sseUrl}"`}
+    ${ansis_default.blue`}`}
+  ${purple`}`}
+${ansis_default.yellow`}`}
+`;
+}
+
+//#endregion
+//#region src/updateConfigs/trae.ts
+async function updateTraeConfig(sseUrl, _options) {
+	await open(`trae://trae.ai-ide/mcp-import?type=http&name=uni&config=${Buffer$1.from(JSON.stringify({ url: sseUrl })).toString("base64")}`);
+	consola.log(`${CONSOLE_LOG_PREFIX}${ansis_default.gray(`自动配置了trae链接，请在trae中确认`)}`);
+}
+
+//#endregion
+//#region src/updateConfigs/trae-cn.ts
+async function updateTraeCNConfig(sseUrl, _options) {
+	await open(`trae-cn://trae.ai-ide/mcp-import?type=http&name=uni&config=${Buffer$1.from(JSON.stringify({ url: sseUrl })).toString("base64")}`);
+	consola.log(`${CONSOLE_LOG_PREFIX}${ansis_default.gray(`自动配置了trae-cn链接，请在trae-cn中确认`)}`);
+}
+
+//#endregion
+//#region src/updateConfigs/vscode.ts
+async function updateVSCodeConfig(root, sseUrl, _options) {
+	await fs.mkdir(join(root, ".vscode"), { recursive: true });
+	const mcp = existsSync(join(root, ".vscode/mcp.json")) ? JSON.parse(await fs.readFile(join(root, ".vscode/mcp.json"), "utf-8") || "{}") : {};
+	mcp.servers ||= {};
+	mcp.servers.uni = {
+		type: "http",
+		url: sseUrl
+	};
+	await fs.writeFile(join(root, ".vscode/mcp.json"), `${JSON.stringify(mcp, null, 2)}\n`);
+	consola.log(`${CONSOLE_LOG_PREFIX}${ansis_default.gray(`Updated config file ${join(root, ".vscode/mcp.json")}`)}`);
+}
+
+//#endregion
+//#region src/updateConfigs/windsurf.ts
+async function updateWindsurfConfig(sseUrl, _options) {
+	const windsurfDir = join(homedir(), ".codeium", "windsurf");
+	const windsurfConfigPath = join(windsurfDir, "mcp_config.json");
+	try {
+		await fs.mkdir(windsurfDir, { recursive: true });
+		const config = existsSync(windsurfConfigPath) ? JSON.parse(await fs.readFile(windsurfConfigPath, "utf-8").catch(() => "{}") || "{}") : {};
+		config.mcpServers ||= {};
+		config.mcpServers.uni = { serverUrl: sseUrl };
+		await fs.writeFile(windsurfConfigPath, `${JSON.stringify(config, null, 2)}\n`);
+		consola.log(`${CONSOLE_LOG_PREFIX}${ansis_default.gray(`Updated config file ${windsurfConfigPath}`)}`);
+	} catch (e) {
+		consola.error(`${CONSOLE_LOG_PREFIX}${ansis_default.red(`Failed to update ${windsurfConfigPath}`)}${e}`);
+	}
+}
+
+//#endregion
+//#region src/updateConfigs/index.ts
+const CONSOLE_LOG_PREFIX = ansis_default.cyan.bold`[MCP] `;
+async function updateConfigs(root, sseUrl, options) {
+	const { updateConfig = false } = options;
+	if (updateConfig === false) {
+		consola.log(`${CONSOLE_LOG_PREFIX}请手动配置mcpServers`);
+		consola.box(mcpServersConfig(sseUrl));
+	}
+	const configPromises = (updateConfig === "auto" ? [
+		existsSync(join(root, ".cursor")) ? "cursor" : null,
+		existsSync(join(root, ".vscode")) ? "vscode" : null,
+		existsSync(join(homedir(), ".codeium", "windsurf")) ? "windsurf" : null,
+		existsSync(join(root, ".mcp.json")) ? "claude-code" : null,
+		existsSync(join(homedir(), ".trae-cn")) ? "trae-cn" : null,
+		existsSync(join(homedir(), ".trae")) ? "trae" : null
+	].filter((x) => x !== null) : Array.isArray(updateConfig) ? updateConfig : []).map(async (config) => {
+		switch (config) {
+			case "cursor":
+				await updateCursorConfig(root, sseUrl, options);
+				break;
+			case "vscode":
+				await updateVSCodeConfig(root, sseUrl, options);
+				break;
+			case "windsurf":
+				await updateWindsurfConfig(sseUrl, options);
+				break;
+			case "claude-code":
+				await updateClaudeConfig(root, sseUrl, options);
+				break;
+			case "trae-cn":
+				await updateTraeCNConfig(sseUrl, options);
+				break;
+			case "trae":
+				await updateTraeConfig(sseUrl, options);
+				break;
+		}
+	});
+	await Promise.all(configPromises);
+}
+
+//#endregion
+//#region src/index.ts
+function uniMcp(options = {}) {
+	return {
+		name: "uni-mcp",
+		enforce: "post",
+		async configResolved(config) {
+			const url = connectServer(await createMcpServer(config, options), options);
+			await updateConfigs(searchForWorkspaceRoot(config.root), url, options);
+		}
+	};
+}
+
+//#endregion
+export { uniMcp as default };

package/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@uni-helper/mcp",
+  "type": "module",
+  "version": "0.0.1",
+  "packageManager": "pnpm@10.6.2",
+  "description": "mcp - uniapp也得有ai开发体验",
+  "author": "FliPPeDround <flippedround@qq.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "funding": "https://afdian.com/a/flippedround",
+  "homepage": "https://github.com/uni-helper/mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/uni-helper/mcp.git"
+  },
+  "bugs": "https://github.com/uni-helper/mcp/issues",
+  "keywords": [
+    "uni",
+    "uni-app",
+    "uni-helper",
+    "mcp",
+    "miniapp"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist",
+    "vectorStore"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch ./src",
+    "lint": "eslint",
+    "task": "tsx ./tasks/uniappDocs/index.ts",
+    "play": "cd playground && pnpm dev",
+    "lint:fix": "eslint --fix",
+    "inspect": "mcp-inspector",
+    "prepublishOnly": "pnpm build",
+    "release": "bumpp",
+    "test": "vitest",
+    "prepare": "simple-git-hooks",
+    "postinstall": "node scripts/download-model.cjs"
+  },
+  "peerDependencies": {
+    "uniapp": "*",
+    "vite": ">=3.1.0"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.19.9",
+    "@huggingface/transformers": "^3.8.1",
+    "@langchain/community": "^1.1.4",
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "consola": "^3.2.3",
+    "fs-extra": "^11.3.3",
+    "hnswlib-node": "^3.0.0",
+    "hono": "^4.11.4",
+    "langchain": "^1.2.8",
+    "local-pkg": "^1.1.2",
+    "open": "^11.0.0",
+    "pathe": "^2.0.3",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^7.0.1",
+    "@antfu/utils": "^9.3.0",
+    "@langchain/core": "^1.1.15",
+    "@langchain/ollama": "^1.2.0",
+    "@langchain/textsplitters": "^1.0.1",
+    "@modelcontextprotocol/inspector": "^0.18.0",
+    "@types/debug": "^4.1.12",
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.0.8",
+    "@types/turndown": "^5.0.6",
+    "ansis": "^4.2.0",
+    "bumpp": "^10.4.0",
+    "cheerio": "^1.1.2",
+    "debug": "^4.4.3",
+    "eslint": "^9.39.2",
+    "lint-staged": "^16.2.7",
+    "simple-git-hooks": "^2.13.1",
+    "tinyexec": "^1.0.2",
+    "tsdown": "^0.20.0-beta.3",
+    "tsx": "^4.21.0",
+    "turndown": "^7.2.2",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17",
+    "vitest-package-exports": "^1.1.2"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm i --frozen-lockfile --ignore-scripts --offline && npx lint-staged"
+  },
+  "lint-staged": {
+    "*": "eslint --fix"
+  }
+}

package/vectorStore/uniapp/args.json

@@ -0,0 +1 @@
+{"space":"cosine","numDimensions":1024}