@uni-helper/mcp 0.0.2-beta.2 → 0.0.4

package/README.md

@@ -1,4 +1,8 @@
-# [WIP]uniapp MCP plugin
+# UniAPP MCP
+
+> 访问[uni-helper/skills](https://github.com/uni-helper/skills)获取`skills`。
+
+使用 `MCP + RAG` 方案来查询 uniapp 文档。
 
 ## 安装
 
@@ -6,16 +10,21 @@
 pnpm add @uni-helper/mcp -D
 ```
 
-## 配置
-
-在 `vite.config.ts` 中添加如下配置：
-
-```ts
-import mcp from '@uni-helper/mcp'
-import uni from '@uni-helper/plugin-uni'
-import { defineConfig } from 'vite'
+## 配置 MCP 服务器
+```json
+{
+  "mcpServers": {
+    "uni-doc": {
+      "command": "uni-mcp"
+    }
+  }
+}
+```
 
-export default defineConfig({
-  plugins: [uni(), mcp()],
-})
+## 注意如果使用pnpm，请在`pnpm-workspace.yaml`中添加如下配置：
+确保能正确构建`@uni-helper/mcp`插件
+```yaml
+onlyBuiltDependencies:
+  - hnswlib-node
+  - '@uni-helper/mcp'
 ```

package/dist/index.mjs

@@ -1,11 +1,5 @@
-import process from "node:process";
-import minimist from "minimist";
-import { searchForWorkspaceRoot } from "vite";
-import { serve } from "@hono/node-server";
-import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
-import fkill from "fkill";
-import { Hono } from "hono";
-import { cors } from "hono/cors";
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { dirname, join } from "node:path";
@@ -13,188 +7,9 @@ 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));
-	fkill(port, {
-		force: true,
-		silent: true
-	}).then(() => {
-		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`;
-}
+//#region package.json
+var version = "0.0.4";
 
 //#endregion
 //#region src/docs/index.ts
@@ -214,211 +29,33 @@ async function loadVectorStore(vectorName, _embeddings) {
 }
 
 //#endregion
-//#region package.json
-var version = "0.0.2-beta.2";
-
-//#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) {
+//#region src/server/index.ts
+async function createMcpServer() {
 	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) => ({
+		return { content: (await (await loadVectorStore("uniapp")).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 isBuild() {
-	return minimist(process.argv.slice(2))._.includes("build");
-}
-function uniMcp(options = {}) {
-	if (isBuild()) return;
-	return {
-		name: "uni-mcp",
-		enforce: "post",
-		async configResolved(config) {
-			const url = connectServer(await createMcpServer(config, options), options);
-			await updateConfigs(searchForWorkspaceRoot(config.root), url, options);
-		}
-	};
+async function main() {
+	const server = await createMcpServer();
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
 }
+main().catch(console.error);
 
 //#endregion
-export { uniMcp as default, isBuild };
+export {  };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@uni-helper/mcp",
   "type": "module",
-  "version": "0.0.2-beta.2",
-  "description": "mcp - uniapp也得有ai开发体验",
+  "version": "0.0.4",
+  "description": "为uniapp提供ai开发体验",
   "author": "FliPPeDround <flippedround@qq.com>",
   "license": "MIT",
   "funding": "https://afdian.com/a/flippedround",
@@ -17,6 +17,8 @@
     "uni-app",
     "uni-helper",
     "mcp",
+    "ai",
+    "agent",
     "miniapp"
   ],
   "sideEffects": false,
@@ -28,31 +30,29 @@
   },
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
-  "types": "./dist/index.d.mts",
+  "bin": {
+    "uni-mcp": "./dist/index.mjs"
+  },
   "files": [
     "dist",
     "scripts",
     "vectorStore"
   ],
-  "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",
+    "cac": "^6.7.14",
+    "commander": "^14.0.2",
     "consola": "^3.2.3",
-    "fkill": "^10.0.3",
     "fs-extra": "^11.3.3",
     "hnswlib-node": "^3.0.0",
-    "hono": "^4.11.4",
     "langchain": "^1.2.8",
     "local-pkg": "^1.1.2",
     "minimist": "^1.2.8",
     "open": "^11.0.0",
     "pathe": "^2.0.3",
+    "which": "^6.0.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
@@ -79,7 +79,6 @@
     "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"
   },
@@ -93,12 +92,13 @@
     "build": "tsdown",
     "dev": "tsdown --watch ./src",
     "lint": "eslint",
-    "task": "tsx ./tasks/uniappDocs/index.ts",
+    "task": "node ./tasks/uniappDocs/index.ts",
     "play": "cd playground && pnpm dev",
     "lint:fix": "eslint --fix",
     "inspect": "mcp-inspector",
     "release": "bumpp",
+    "pull:repo": "node scripts/cli.ts",
     "test": "vitest",
-    "postinstall": "node scripts/download-model.mjs"
+    "postinstall": "node scripts/download-model.mjs && node scripts/link-global.mjs"
   }
 }

package/scripts/download-model.mjs

@@ -2,10 +2,13 @@ import process from 'node:process'
 import { env } from '@huggingface/transformers'
 import { HuggingFaceTransformersEmbeddings } from '@langchain/community/embeddings/huggingface_transformers'
 
+if (process.env.CI) {
+  process.exit(0)
+}
+
 async function downloadModel() {
   env.version = 'master'
   env.remoteHost = 'https://www.modelscope.cn/models'
-  await new Promise(resolve => setTimeout(resolve, 1000))
   const embeddings = new HuggingFaceTransformersEmbeddings({
     model: 'onnx-community/Qwen3-Embedding-0.6B-ONNX',
     pretrainedOptions: {

package/scripts/link-global.mjs

@@ -0,0 +1,38 @@
+import { execSync } from 'node:child_process'
+import { dirname, join } from 'node:path'
+import process from 'node:process'
+import { fileURLToPath } from 'node:url'
+import which from 'which'
+
+if (process.env.CI) {
+  process.exit(0)
+}
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+
+async function linkGlobal() {
+  const resolvedOrNull = await which('uni-mcp', { nothrow: true })
+  if (resolvedOrNull) {
+    return
+  }
+
+  const rootDir = join(__dirname, '..')
+
+  console.log('🔧 正在将 uni-mcp 链接到全局...')
+
+  try {
+    execSync('npm link -y', {
+      cwd: rootDir,
+      stdio: 'inherit',
+      shell: true,
+    })
+    console.log('✅ uni-mcp 已成功链接到全局')
+  }
+  catch (err) {
+    console.error('❌ 全局链接失败:', err.message)
+    process.exit(1)
+  }
+}
+
+linkGlobal()

package/dist/index.d.mts

@@ -1,80 +0,0 @@
-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 isBuild(): boolean;
-declare function uniMcp(options?: UniMcpOptions): Plugin | undefined;
-//#endregion
-export { uniMcp as default, isBuild };