exploria-ui-mcp-server 2.2.7 → 2.2.8

package/README.md

@@ -39,7 +39,7 @@ MCP Server 在项目架构中扮演着核心角色，作为 AI IDE 与 Exploria
 
 | 组件名称                 | 功能描述                                                                |
 | ------------------------ | ----------------------------------------------------------------------- |
-| **ExploriaUIMCPServer**  | 主服务器类，负责协调所有组件，处理服务生命周期管理                      |
+| **index.ts**  | 入口文件，负责初始化服务、建立与 AI IDE 的连接、注册工具/资源/提示模块 |
 | **McpServer**            | 来自 @modelcontextprotocol/sdk 的核心 MCP 服务器实例，处理 MCP 协议通信 |
 | **StdioServerTransport** | 标准输入输出传输层，用于与 AI IDE 通信                                  |
 | **DocumentParser**       | 文档解析器，负责解析和处理 Exploria UI 文档                             |
@@ -237,7 +237,7 @@ vector[secondaryIndex] -= weight * 0.5
 │                          │ (标准输入输出管道)                 │
 │                          ▼                                   │
 │  ┌─────────────────────────────────────────────────────┐      │
-│  │              ExploriaUIMCPServer                    │      │
+│  │              index.ts (入口模块)                     │      │
 │  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐ │      │
 │  │  │   Tools     │  │  Resources  │  │   Prompts   │ │      │
 │  │  │ (工具注册)   │  │  (资源注册) │  │  (提示注册) │ │      │
@@ -263,7 +263,7 @@ vector[secondaryIndex] -= weight * 0.5
 
 | 组件                     | 职责                     | 关键方法/属性                                 |
 | ------------------------ | ------------------------ | --------------------------------------------- |
-| **ExploriaUIMCPServer**  | 主服务器类，管理生命周期 | `start()`, `shutdown()`, `initializeServer()` |
+| **index.ts**  | 入口模块，启动服务、管理连接 | `startServer()`, `setupEventHandlers()` |
 | **McpServer**            | MCP SDK 核心实例         | 处理协议通信、注册工具/资源/提示              |
 | **StdioServerTransport** | 标准输入输出传输层       | 建立与 IDE 的管道连接                         |
 | **KnowledgeService**     | 向量数据库服务           | `searchKnowledge()`, `getComponentDetails()`  |
@@ -461,12 +461,13 @@ MCP Server 与 AI IDE 之间支持三种传输协议：
 
 1. AI 相关 IDE 通过 MCP 协议连接并请求启动 MCP Server
 2. IDE 实际调用的是 NPM 包中 package.json 定义的可执行命令
-3. 可执行命令指向 `dist/index.js` 文件，该文件会实例化并启动 ExploriaUIMCPServer 类
-4. ExploriaUIMCPServer 类初始化流程：
+3. 可执行命令指向 `dist/index.js` 文件，该文件直接调用 `startServer()` 函数启动服务
+4. 服务启动流程：
     - 加载 package.json 获取配置信息
-    - 设置事件处理器（错误处理、信号处理等）
-    - 初始化 McpServer 实例
+    - 初始化知识索引（加载预构建向量数据库）
+    - 创建 McpServer 实例
     - 注册所有工具、资源和提示模块
+    - 设置事件处理器（错误处理、信号处理等）
     - 创建并连接 StdioServerTransport
 5. 连接建立后，服务器通过 MCP 协议与 IDE 进行通信，提供各项功能
 

package/dist/index.js

@@ -14025,66 +14025,49 @@ function dh(e) {
 }
 //#endregion
 //#region src/index.ts
-var fh = class {
-	server = null;
-	packageJson;
-	transport = null;
-	constructor() {
-		this.loadPackageJson(), this.setupEventHandlers();
-	}
-	loadPackageJson() {
-		try {
-			this.packageJson = Hm();
-		} catch (e) {
-			console.error("🔴 加载 package.json 失败:", e), process.exit(1);
-		}
-	}
-	setupEventHandlers() {
-		process.stdin.on("error", (e) => {
-			console.error("🔴 标准输入错误:", e.message), this.shutdown(1);
-		}), process.stdout.on("error", (e) => {
-			console.error("🔴 标准输出错误:", e.message), this.shutdown(1);
-		}), process.on("SIGINT", () => {
-			console.error("\n🟠 收到 SIGINT 信号，正在关闭服务器..."), this.shutdown(0);
-		}), process.on("SIGTERM", () => {
-			console.error("\n🟠 收到 SIGTERM 信号，正在关闭服务器..."), this.shutdown(0);
-		}), process.on("uncaughtException", (e) => {
-			console.error("🔴 未捕获异常:", e.message), console.error("🔴 异常堆栈:", e.stack), this.shutdown(1);
-		}), process.on("unhandledRejection", (e) => {
-			console.error("🔴 未处理的 Promise 拒绝:", e), this.shutdown(1);
-		});
-	}
-	initializeServer() {
-		try {
-			console.error("\n🔄 正在初始化知识索引...");
-			let e = nh.initialize();
-			nh.getStatus(), console.error("📚 知识索引初始化完成"), console.error(`   ├─ 文档数: ${e.metrics.documentCount}`), console.error(`   ├─ 切片数: ${e.metrics.chunkCount}`), console.error(`   └─ 构建耗时: ${e.metrics.buildTimeMs}ms`), this.server = new Sm({
-				name: this.packageJson.name,
-				version: this.packageJson.version,
-				description: this.packageJson.description
-			}), console.error("\n🔧 正在注册工具、资源和提示..."), dh(this.server), ah(this.server), Rm(this.server), console.error("✅ 成功注册所有工具、资源和提示");
-		} catch (e) {
-			console.error("🔴 初始化 MCP Server 失败:", e), console.error("🔴 错误详情:", e instanceof Error ? e.stack : ""), process.exit(1);
-		}
-	}
-	async start() {
-		try {
-			if (this.initializeServer(), this.transport = new Fm(), !this.server || !this.transport) throw Error("服务器或传输层未初始化");
-			await this.server.connect(this.transport), console.error("\n✅ Exploria UI MCP Server 已成功启动"), console.error(`📦 服务器名称: ${this.packageJson.name}`), console.error(`📌 服务器版本: ${this.packageJson.version}`), console.error("🔗 等待 AI IDE 连接...\n");
-		} catch (e) {
-			console.error("🔴 启动 MCP Server 失败:", e), this.shutdown(1);
-		}
-	}
-	async shutdown(e) {
+function fh(e, t) {
+	let n = async (t) => {
 		try {
-			this.server && (await this.server.close(), console.error("✅ MCP Server 已成功关闭"));
+			await e.close(), console.error("✅ MCP Server 已成功关闭");
 		} catch (e) {
 			console.error("🔴 关闭服务器时发生错误:", e);
 		} finally {
-			process.exit(e);
+			process.exit(t);
+		}
+	};
+	process.stdin.on("error", (e) => {
+		console.error("🔴 标准输入错误:", e.message), n(1);
+	}), process.stdout.on("error", (e) => {
+		console.error("🔴 标准输出错误:", e.message), n(1);
+	}), process.on("SIGINT", () => {
+		console.error("\n🟠 收到 SIGINT 信号，正在关闭服务器..."), n(0);
+	}), process.on("SIGTERM", () => {
+		console.error("\n🟠 收到 SIGTERM 信号，正在关闭服务器..."), n(0);
+	}), process.on("uncaughtException", (e) => {
+		console.error("🔴 未捕获异常:", e.message), console.error("🔴 异常堆栈:", e.stack), n(1);
+	}), process.on("unhandledRejection", (e) => {
+		console.error("🔴 未处理的 Promise 拒绝:", e), n(1);
+	});
+}
+async function ph() {
+	let e, t;
+	try {
+		let n = Hm();
+		console.error("\n🔄 正在初始化知识索引...");
+		let r = nh.initialize();
+		nh.getStatus(), console.error("📚 知识索引初始化完成"), console.error(`   ├─ 文档数: ${r.metrics.documentCount}`), console.error(`   ├─ 切片数: ${r.metrics.chunkCount}`), console.error(`   └─ 构建耗时: ${r.metrics.buildTimeMs}ms`), e = new Sm({
+			name: n.name,
+			version: n.version,
+			description: n.description
+		}), console.error("\n🔧 正在注册工具、资源和提示..."), dh(e), ah(e), Rm(e), console.error("✅ 成功注册所有工具、资源和提示"), t = new Fm(), fh(e, t), await e.connect(t), console.error("\n✅ Exploria UI MCP Server 已成功启动"), console.error(`📦 服务器名称: ${n.name}`), console.error(`📌 服务器版本: ${n.version}`), console.error("🔗 等待 AI IDE 连接...\n");
+	} catch (t) {
+		if (console.error("🔴 启动 MCP Server 失败:", t), console.error("🔴 错误详情:", t instanceof Error ? t.stack : ""), e) try {
+			await e.close();
+		} catch (e) {
+			console.error("🔴 关闭服务器时发生错误:", e);
 		}
+		process.exit(1);
 	}
-};
-new fh().start();
+}
+ph();
 //#endregion
-export { fh as ExploriaUIMCPServer };

package/dist/knowledge/vector-db.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-04-13T09:22:20.404Z",
+  "generatedAt": "2026-04-13T09:27:20.599Z",
   "docsRoot": "C:\\Users\\YYWD4\\Desktop\\exploria-ui-document\\src\\views\\document\\pages",
   "buildMode": "prebuild",
   "idfMap": {
@@ -120719,7 +120719,7 @@
     }
   ],
   "metrics": {
-    "buildTimeMs": 165.85,
+    "buildTimeMs": 154.75,
     "documentCount": 74,
     "chunkCount": 415,
     "averageChunkLength": 383.75,

package/dist/logs/{build-log-2026-04-13-09-22-20.json → build-log-2026-04-13-09-27-20.json}

@@ -1,12 +1,12 @@
 {
-  "timestamp": "2026-04-13T09:22:20.400Z",
+  "timestamp": "2026-04-13T09:27:20.596Z",
   "buildMode": "prebuild",
   "docsRoot": "C:\\Users\\YYWD4\\Desktop\\exploria-ui-document\\src\\views\\document\\pages",
   "statistics": {
     "documentRootCount": 74,
     "documentCount": 74,
     "chunkCount": 415,
-    "buildTimeMs": 165.85,
+    "buildTimeMs": 154.75,
     "vectorDimension": 256
   },
   "documentRoots": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exploria-ui-mcp-server",
-  "version": "2.2.7",
+  "version": "2.2.8",
   "description": "MCP Server for Exploria UI Component Library",
   "bin": {
     "exploria-ui-mcp-server": "./dist/index.js"