@uni-helper/mcp 0.0.4 → 0.0.6

package/README.md

@@ -25,6 +25,5 @@ pnpm add @uni-helper/mcp -D
 确保能正确构建`@uni-helper/mcp`插件
 ```yaml
 onlyBuiltDependencies:
-  - hnswlib-node
   - '@uni-helper/mcp'
 ```

package/dist/docs/index.mjs

@@ -0,0 +1,33 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { env } from "@huggingface/transformers";
+import { connect } from "@lancedb/lancedb";
+import { HuggingFaceTransformersEmbeddings } from "@langchain/community/embeddings/huggingface_transformers";
+import { LanceDB } from "@langchain/community/vectorstores/lancedb";
+
+//#region src/docs/index.ts
+const __dirname = dirname(fileURLToPath(import.meta.url));
+async function loadVectorStore(vectorName, _embeddings) {
+	const vectorMap = { uniapp: {
+		dir: join(__dirname, "../../", "vectorStore"),
+		tableName: "uniapp_docs"
+	} };
+	const vectorDir = vectorMap[vectorName].dir;
+	const table = await (await connect(vectorDir)).openTable(vectorMap[vectorName].tableName);
+	env.version = "master";
+	env.remoteHost = "https://www.modelscope.cn/models";
+	return new LanceDB(_embeddings ?? new HuggingFaceTransformersEmbeddings({
+		model: "onnx-community/Qwen3-Embedding-0.6B-ONNX",
+		pretrainedOptions: {
+			dtype: "int8",
+			device: "cpu"
+		}
+	}), {
+		table,
+		uri: vectorDir,
+		tableName: vectorMap[vectorName].tableName
+	});
+}
+
+//#endregion
+export { loadVectorStore };

package/dist/index.mjs

@@ -1,54 +1,7 @@
 #!/usr/bin/env node
+import { createMcpServer } from "./server/index.mjs";
 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";
-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";
 
-//#region package.json
-var version = "0.0.4";
-
-//#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.version = "master";
-	env.remoteHost = "https://www.modelscope.cn/models";
-	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 src/server/index.ts
-async function createMcpServer() {
-	const server = new McpServer({
-		name: "uni",
-		version
-	});
-	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")).similaritySearch(query, 3)).map((doc) => ({
-			type: "text",
-			text: JSON.stringify(doc)
-		})) };
-	});
-	return server;
-}
-
-//#endregion
 //#region src/index.ts
 async function main() {
 	const server = await createMcpServer();

package/dist/package.mjs

@@ -0,0 +1,5 @@
+//#region package.json
+var version = "0.0.6";
+
+//#endregion
+export { version };

package/dist/server/index.mjs

@@ -0,0 +1,29 @@
+import { version } from "../package.mjs";
+import { loadVectorStore } from "../docs/index.mjs";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+
+//#region src/server/index.ts
+async function createMcpServer() {
+	const server = new McpServer({
+		name: "uni",
+		version
+	});
+	server.registerTool("search-docs-by-Uniapp-official", {
+		title: "搜索 Uniapp 官方文档",
+		description: "在 Uniapp 文档知识库中进行搜索，可查找相关信息、代码示例、API参考文档和操作指南。当您需要解答关于Uniapp文档的问题、查找特定文档内容、了解功能运作原理或定位实现细节时，可使用此工具。使用此工具前，请对用户的原始查询进行智能改写和优化，将口语化或模糊的表述转换为技术术语和关键词，以最大化检索到相关的有用数据。搜索结果将返回带有标题的上下文相关内容，并附有直达文档页面的链接。",
+		inputSchema: {
+			query: z.string().describe("用于搜索内容的查询语句"),
+			k: z.number().int().min(1).default(3).describe("返回的结果数量，默认值为3")
+		}
+	}, async ({ query, k = 3 }) => {
+		return { content: (await (await loadVectorStore("uniapp")).similaritySearch(query, k)).map((doc) => ({
+			type: "text",
+			text: JSON.stringify(doc)
+		})) };
+	});
+	return server;
+}
+
+//#endregion
+export { createMcpServer };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uni-helper/mcp",
   "type": "module",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "为uniapp提供ai开发体验",
   "author": "FliPPeDround <flippedround@qq.com>",
   "license": "MIT",
@@ -40,18 +40,11 @@
   ],
   "dependencies": {
     "@huggingface/transformers": "^3.8.1",
+    "@lancedb/lancedb": "0.22.3",
     "@langchain/community": "^1.1.4",
     "@modelcontextprotocol/sdk": "^1.25.2",
-    "cac": "^6.7.14",
-    "commander": "^14.0.2",
     "consola": "^3.2.3",
-    "fs-extra": "^11.3.3",
-    "hnswlib-node": "^3.0.0",
     "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"
   },
@@ -63,20 +56,15 @@
     "@langchain/textsplitters": "^1.0.1",
     "@modelcontextprotocol/inspector": "^0.18.0",
     "@types/debug": "^4.1.12",
-    "@types/fs-extra": "^11.0.4",
-    "@types/minimist": "^1.2.5",
     "@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",
     "vitest": "^4.0.17",

package/scripts/link-global.mjs

@@ -2,6 +2,7 @@ import { execSync } from 'node:child_process'
 import { dirname, join } from 'node:path'
 import process from 'node:process'
 import { fileURLToPath } from 'node:url'
+import consola from 'consola'
 import which from 'which'
 
 if (process.env.CI) {
@@ -13,24 +14,41 @@ const __dirname = dirname(__filename)
 
 async function linkGlobal() {
   const resolvedOrNull = await which('uni-mcp', { nothrow: true })
-  if (resolvedOrNull) {
-    return
-  }
-
   const rootDir = join(__dirname, '..')
+  consola.start('正在安装 @uni-helper/mcp')
 
-  console.log('🔧 正在将 uni-mcp 链接到全局...')
+  if (resolvedOrNull) {
+    try {
+      execSync('npm unlink -g uni-mcp', {
+        cwd: rootDir,
+        stdio: 'ignore',
+        shell: true,
+      })
+    }
+    catch (err) {
+      consola.error('清除旧链接失败:', err.message)
+      process.exit(1)
+    }
+  }
 
   try {
-    execSync('npm link -y', {
+    execSync('npm link -y --ignore-scripts', {
       cwd: rootDir,
-      stdio: 'inherit',
+      stdio: 'ignore',
       shell: true,
     })
-    console.log('✅ uni-mcp 已成功链接到全局')
+    consola.success('安装成功')
+    consola.info(`MCP 配置示例：
+{
+  "mcpServers": {
+    "uni-doc": {
+      "command": "uni-mcp"
+    }
+  }
+}`)
   }
   catch (err) {
-    console.error('❌ 全局链接失败:', err.message)
+    consola.error('全局链接失败:', err.message)
     process.exit(1)
   }
 }