exploria-ui-mcp-server 2.1.1 → 2.1.3

package/README.md

@@ -1,37 +1,28 @@
 # Exploria UI MCP Server
 
-Exploria UI MCP Server 是一个基于 MCP（Model Context Protocol）协议的服务，允许 AI 客户端（如 Cursor、Trae IDE）访问和查询 Exploria UI 组件库的文档和信息。
+基于 MCP（Model Context Protocol）协议的服务，允许 AI 客户端（如 Cursor、Trae IDE）访问和查询 Exploria UI 组件库的文档和信息。
 
 ## 1. MCP 协议简介
 
 ### 1.1 什么是 MCP？
 
-MCP（Model Context Protocol）是 AI 工具世界的「USB 标准」，它允许 AI 应用（如 Cursor、Trae IDE）通过统一的接口访问自定义数据和功能。
+MCP 是 AI 工具世界的「USB 标准」，允许 AI 应用通过统一接口访问自定义数据和功能。
 
-### 1.2 核心设计理念
+### 1.2 核心特性
 
-- **统一接口**：为所有 AI 工具提供统一的访问方式，避免为每个 AI 工具单独开发适配层
-- **轻量通信**：默认使用标准输入输出（stdio）进行通信，无需网络端口
-- **自动管理**：由 AI 客户端自动启动、管理和停止，无需手动干预
+- **统一接口**：为所有 AI 工具提供统一访问方式
+- **轻量通信**：使用标准输入输出（stdio）通信，无需网络端口
+- **自动管理**：由 AI 客户端自动启动、管理和停止
 - **安全可靠**：通过管道通信，避免网络安全风险
 
-### 1.3 通信原理
+### 1.3 通信流程
 
-MCP Server 与 AI IDE 的通信流程：
-
-1. AI IDE（如 Cursor/Trae）启动时读取配置文件
-2. 根据配置中的 `mcpServers` 自动启动 MCP Server 作为子进程
-3. 通过标准输入输出（stdio）与 MCP Server 通信
+1. AI IDE 启动时读取配置文件
+2. 根据 `mcpServers` 配置自动启动 MCP Server 子进程
+3. 通过 stdio 与 MCP Server 通信
 4. 发送初始化指令，获取可用工具列表
-5. 在需要时调用相应工具，获取结果
-6. IDE 关闭时，自动终止 MCP Server 进程
-
-**关键特点**：
-
-- Cursor/Trae 是 MCP Server 的父进程
-- 通信方式：标准输入输出（stdio），不是网络通信
-- 无端口、无 TCP、无 HTTP
-- 所有消息通过 JSON 格式管道传输
+5. 按需调用工具，获取结果
+6. IDE 关闭时自动终止 MCP Server 进程
 
 ## 2. 快速开始
 
@@ -41,59 +32,32 @@ MCP Server 与 AI IDE 的通信流程：
 pnpm install
 ```
 
-### 2.2 Cursor 配置
+### 2.2 AI IDE 配置
 
-1. 打开 Cursor 配置文件：`%APPDATA%\Cursor\cursor_config.json`
-2. 添加以下配置：
+所有 AI IDE 使用统一配置格式：
 
 ```json
 {
     "mcpServers": {
-        "exploria-ui-mcp": {
-            "command": "pnpm",
-            "args": ["serve"],
-            "cwd": "C:\\Users\\YYWD4\\Desktop\\exploria-ui-document\\mcp-server"
+        "exploria-ui-mcp-server": {
+            "command": "npx",
+            "args": ["exploria-ui-mcp-server"]
         }
     }
 }
 ```
 
-**注意**：请将 `cwd` 路径替换为您实际的项目路径。
-
-3. 重启 Cursor，它会自动启动并连接到 MCP Server
-
-### 2.3 Trae IDE 配置
-
-1. 打开 Trae IDE MCP 配置文件：`.trae/mcp.json`（位于项目根目录）
-2. 添加以下配置：
-
-```json
-{
-    "servers": [
-        {
-            "id": "exploria-ui-mcp",
-            "name": "Exploria UI MCP Server",
-            "command": "pnpm",
-            "args": ["mcp:dev"],
-            "cwd": ".",
-            "env": {},
-            "enabled": true
-        }
-    ]
-}
-```
-
-**注意**：
-
-- `cwd` 路径为项目根目录
-- 使用根项目的 `mcp:dev` 脚本启动服务
-- 确保 `enabled` 字段设置为 `true` 以启用该服务器
+#### 具体 IDE 配置
 
-3. 重启 Trae IDE 或重新加载配置，它会自动启动并连接到 MCP Server
+| IDE | 配置文件位置 | 操作步骤 |
+|-----|-------------|----------|
+| Cursor | `%APPDATA%\Cursor\cursor_config.json` | 1. 打开配置文件<br>2. 添加上述配置<br>3. 重启 Cursor |
+| Trae IDE | `.trae/mcp.json`（项目根目录） | 1. 打开配置文件<br>2. 添加上述配置<br>3. 重启 Trae IDE |
+| 其他支持 MCP 的 IDE | 参考官方文档 | 1. 找到 MCP 配置文件<br>2. 添加上述配置<br>3. 重启 IDE |
 
-### 2.4 验证配置
+### 2.3 验证配置
 
-配置完成后，在 AI IDE 中输入类似以下的查询，验证 MCP Server 是否正常工作：
+在 AI IDE 中输入查询验证服务是否正常：
 
 ```
 帮我查一下 button 组件的文档
@@ -103,38 +67,38 @@ pnpm install
 
 ### 3.1 工具（Tools）
 
-| 工具名称                 | 描述                      | 参数                              | 返回值                                 |
-| ------------------------ | ------------------------- | --------------------------------- | -------------------------------------- |
-| `search_documents`       | 搜索 Exploria UI 组件文档 | `query: string`                   | 匹配的组件列表                         |
-| `get_component_list`     | 获取所有组件列表          | 无                                | 所有组件的基本信息                     |
-| `get_component_details`  | 获取指定组件的详细信息    | `componentName: string`           | 组件的详细信息，包括属性、事件、插槽等 |
-| `search_and_get_details` | 搜索并获取组件详情        | `query: string`, `limit?: number` | 匹配的组件列表，包含详细信息           |
+| 工具名称 | 描述 | 参数 | 返回值 |
+|---------|------|------|--------|
+| `search_documents` | 搜索组件文档 | `query: string` | 匹配的组件列表 |
+| `get_component_list` | 获取所有组件列表 | 无 | 所有组件基本信息 |
+| `get_component_details` | 获取组件详情 | `componentName: string` | 组件详细信息（属性、事件、插槽等） |
+| `search_and_get_details` | 搜索并获取组件详情 | `query: string`, `limit?: number` | 匹配的组件列表（含详情） |
 
 ### 3.2 资源（Resources）
 
-| 资源 URI                        | 描述           | 返回值                           |
-| ------------------------------- | -------------- | -------------------------------- |
-| `status://exploria-ui-server`   | 服务器状态信息 | 服务器运行状态、版本、运行时间等 |
-| `docs://exploria-ui-api`        | API 文档       | 完整的 API 文档                  |
-| `components://exploria-ui-list` | 组件列表资源   | 所有组件的基本信息               |
+| 资源 URI | 描述 | 返回值 |
+|---------|------|--------|
+| `status://exploria-ui-server` | 服务器状态 | 运行状态、版本、运行时间等 |
+| `docs://exploria-ui-api` | API 文档 | 完整 API 文档 |
+| `components://exploria-ui-list` | 组件列表 | 所有组件基本信息 |
 
 ### 3.3 提示（Prompts）
 
-| 提示名称                  | 描述             | 参数                                         | 返回值           |
-| ------------------------- | ---------------- | -------------------------------------------- | ---------------- |
-| `component_documentation` | 生成组件文档模板 | `componentName: string`                      | 组件文档模板     |
-| `usage_example`           | 生成组件使用示例 | `componentName: string`, `scenario?: string` | 组件使用示例代码 |
+| 提示名称 | 描述 | 参数 | 返回值 |
+|---------|------|------|--------|
+| `component_documentation` | 生成组件文档模板 | `componentName: string` | 组件文档模板 |
+| `usage_example` | 生成组件使用示例 | `componentName: string`, `scenario?: string` | 组件使用示例代码 |
 
 ## 4. 项目架构
 
 ### 4.1 核心模块
 
-| 模块          | 功能                                   |
-| ------------- | -------------------------------------- |
-| **Tools**     | 可执行功能，如搜索文档、获取组件详情   |
-| **Resources** | 提供只读数据，如服务器状态、API 文档   |
-| **Prompts**   | 预定义模板，用于生成组件文档和使用示例 |
-| **Utils**     | 工具类，如文档解析器                   |
+| 模块 | 功能 |
+|------|------|
+| **Tools** | 可执行功能（搜索文档、获取组件详情等） |
+| **Resources** | 提供只读数据（服务器状态、API 文档等） |
+| **Prompts** | 预定义模板（生成文档、使用示例等） |
+| **Utils** | 工具类（文档解析器等） |
 
 ### 4.2 项目结构
 
@@ -157,7 +121,7 @@ src/
 │   ├── componentDocumentation.ts  # 生成组件文档模板
 │   └── usageExample.ts            # 生成组件使用示例
 └── utils/                # 工具类
-    └── documentParser.ts # 文档解析器，处理组件文档
+    └── documentParser.ts # 文档解析器
 ```
 
 ## 5. 开发与调试
@@ -170,79 +134,86 @@ pnpm build
 
 ### 5.2 本地运行（仅开发阶段）
 
-**注意**：在生产环境中，MCP Server 由 AI IDE 自动启动和管理，无需手动运行。以下命令仅用于开发和调试阶段。
+在项目根目录执行：
 
 ```bash
-# 从根项目启动 MCP Server 开发模式
+# 开发模式
 pnpm mcp:dev
 
 # 构建 MCP Server
 pnpm mcp:build
 
-# 运行构建后的 MCP Server
+# 运行构建后的服务
 pnpm mcp:start
 ```
 
-**注意**：这些命令需要在项目根目录下执行，而不是 mcp-server 子目录。
-
-### 5.3 使用 MCP Dev 工具
-
-安装 MCP Dev 工具进行调试：
-
-```bash
-npm install -g @modelcontextprotocol/dev
-```
-
-然后在项目目录中运行：
-
-```bash
-mcp dev src/index.ts
-```
-
-这会模拟 AI IDE 启动和调用流程，便于调试。
-
 ## 6. 扩展指南
 
 ### 6.1 添加新工具
 
-1. 在 `src/tools/` 目录下创建新的工具文件，如 `newTool.ts`
+1. 在 `src/tools/` 目录下创建新工具文件（如 `newTool.ts`）
 2. 实现工具函数并注册到 MCP Server
 3. 在 `src/tools/index.ts` 中导入并注册新工具
 
 ### 6.2 添加新资源
 
-1. 在 `src/resources/` 目录下创建新的资源文件，如 `newResource.ts`
+1. 在 `src/resources/` 目录下创建新资源文件
 2. 实现资源函数并注册到 MCP Server
 3. 在 `src/resources/index.ts` 中导入并注册新资源
 
 ### 6.3 添加新提示
 
-1. 在 `src/prompts/` 目录下创建新的提示文件，如 `newPrompt.ts`
+1. 在 `src/prompts/` 目录下创建新提示文件
 2. 实现提示函数并注册到 MCP Server
 3. 在 `src/prompts/index.ts` 中导入并注册新提示
 
 ## 7. 技术栈
 
-| 技术                        | 用途                         |
-| --------------------------- | ---------------------------- |
-| `@modelcontextprotocol/sdk` | 官方 MCP TypeScript SDK      |
-| `zod`                       | 用于工具参数的运行时类型校验 |
-| `tsx`                       | 直接运行 TypeScript 代码     |
-| `typescript`                | 类型安全                     |
-| `pnpm`                      | 包管理                       |
+| 技术 | 用途 |
+|-----|------|
+| `@modelcontextprotocol/sdk` | 官方 MCP TypeScript SDK |
+| `zod` | 工具参数运行时类型校验 |
+| `tsx` | 直接运行 TypeScript 代码 |
+| `typescript` | 类型安全 |
+| `pnpm` | 包管理 |
 
 ## 8. 协议兼容性
 
 - 支持 MCP 协议 v1.0+
-- 兼容 Cursor、Trae IDE、Claude Desktop 等支持 MCP 的 AI 客户端
-- 使用标准输入输出（stdio）通信，无需网络端口
+- 兼容 Cursor、Trae IDE、Claude Desktop 等
+- 使用 stdio 通信，无需网络端口
 
 ## 9. 安全特性
 
 - 无网络通信，所有数据通过管道传输
 - 由 AI 客户端自动管理，无需手动暴露服务
-- 支持工具级别的权限控制（通过 MCP SDK 实现）
+- 支持工具级别的权限控制
+
+## 10. 知识库
+
+### 10.1 知识库位置
+
+位于 `mcp-server/public` 文件夹下，包含所有组件、指令、工具函数的详细文档和使用示例。
+
+### 10.2 知识库结构
+
+```
+public/
+├── components/        # 组件文档（按类别分类）
+│   ├── advanced/      # 高级组件
+│   ├── ai/            # AI 相关组件
+│   ├── basic/         # 基础组件
+│   ├── data/          # 数据展示组件
+│   ├── feedback/      # 反馈组件
+│   ├── form/          # 表单组件
+│   ├── geometry/      # 几何相关组件
+│   ├── layout/        # 布局组件
+│   └── navigation/    # 导航组件
+├── directives/        # 指令文档
+├── other/             # 其他功能文档
+└── utils/             # 工具函数文档
+```
 
-## 10. 许可证
+## 11. 许可证
 
 MIT

package/dist/index.js

@@ -13375,13 +13375,12 @@ function Nm(e) {
 //#endregion
 //#region src/prompts/index.ts
 function Pm(e) {
-	Mm(e), Nm(e);
+	console.log("💡 正在注册 MCP 提示..."), Mm(e), Nm(e), console.log("✅ 所有 MCP 提示注册完成");
 }
 //#endregion
 //#region src/resources/apiDocs.ts
-var Fm = import.meta.url.slice(7), Im = t.dirname(Fm);
-function Lm(n) {
-	let r = t.join(Im, "../../package.json"), i = JSON.parse(e.readFileSync(r, "utf-8"));
+function Fm(n) {
+	let r = t.join(process.cwd(), "package.json"), i = JSON.parse(e.readFileSync(r, "utf-8"));
 	n.resource("api_docs", "docs://exploria-ui-api", async (e) => ({ contents: [{
 		uri: e.href,
 		text: `# Exploria UI MCP Server API Documentation
@@ -13483,12 +13482,16 @@ function Lm(n) {
 }
 //#endregion
 //#region src/utils/documentParser.ts
-var Rm = import.meta.url.slice(7), zm = t.dirname(Rm), Bm = t.join(zm, "../../public"), Vm = new class {
+var Im = t.join(process.cwd(), "public"), Lm = new class {
 	docsRoot;
-	constructor(t = Bm) {
-		this.docsRoot = t, e.existsSync(this.docsRoot) || console.warn(`文档根目录不存在: ${this.docsRoot}`);
+	componentListCache = null;
+	componentDetailsCache = /* @__PURE__ */ new Map();
+	constructor(t = Im) {
+		this.docsRoot = t, e.existsSync(this.docsRoot) ? console.log(`📁 文档根目录已设置: ${this.docsRoot}`) : console.warn(`⚠️  文档根目录不存在: ${this.docsRoot}`);
 	}
 	getComponentList() {
+		if (this.componentListCache) return console.log(`✅ 从缓存中获取组件列表，共 ${this.componentListCache.length} 个组件`), this.componentListCache;
+		console.log("🔍 正在扫描文档目录...");
 		let e = [];
 		return this.traverseDocs((t, n, r) => {
 			e.push({
@@ -13497,37 +13500,74 @@ var Rm = import.meta.url.slice(7), zm = t.dirname(Rm), Bm = t.join(zm, "../../pu
 				description: `${n} component for Exploria UI`,
 				path: r
 			});
-		}), e;
+		}), this.componentListCache = e, console.log(`✅ 扫描完成，共找到 ${e.length} 个组件`), e;
 	}
 	traverseDocs(n) {
 		try {
 			if (!e.existsSync(this.docsRoot)) return;
 			e.readdirSync(this.docsRoot).forEach((r) => {
 				let i = t.join(this.docsRoot, r);
-				e.statSync(i).isDirectory() && (r === "components" ? e.readdirSync(i).forEach((r) => {
-					let a = t.join(i, r);
-					e.statSync(a).isDirectory() && e.readdirSync(a).forEach((i) => {
-						let o = t.join(a, i);
-						e.statSync(o).isDirectory() && n(r, i, o);
-					});
-				}) : e.readdirSync(i).forEach((a) => {
-					let o = t.join(i, a);
-					e.statSync(o).isDirectory() && n(r, a, o);
-				}));
+				e.statSync(i).isDirectory() && (r === "components" ? this.traverseComponentsDir(i, n) : this.traverseOtherDir(r, i, n));
 			});
 		} catch (e) {
-			console.error("遍历文档目录时出错:", e);
+			console.error("🔴 遍历文档目录时出错:", e instanceof Error ? e.message : String(e));
 		}
 	}
+	traverseComponentsDir(n, r) {
+		e.readdirSync(n).forEach((i) => {
+			let a = t.join(n, i);
+			e.statSync(a).isDirectory() && e.readdirSync(a).forEach((n) => {
+				let o = t.join(a, n);
+				e.statSync(o).isDirectory() && r(i, n, o);
+			});
+		});
+	}
+	traverseOtherDir(n, r, i) {
+		e.readdirSync(r).forEach((a) => {
+			let o = t.join(r, a);
+			e.statSync(o).isDirectory() && i(n, a, o);
+		});
+	}
 	extractMarkdownFromVue(e) {
 		let t = e.match(/<!--[\s\S]*?-->/);
 		if (t) return t[0].replace(/<!--|-->/g, "").trim();
 		let n = e.match(/<template>[\s\S]*?<\/template>/);
-		return n ? n[0].replace(/<template>|<\/template>/g, "").trim() : "";
+		if (n) return n[0].replace(/<template>|<\/template>/g, "").trim();
+		let r = e.match(/<script[\s\S]*?<\/script>/);
+		if (r) {
+			let e = r[0].match(/\/\*\*[\s\S]*?\*\//);
+			if (e) return e[0].replace(/\/\*\*|\*\//g, "").replace(/^\s*\*\s?/gm, "").trim();
+		}
+		return "";
 	}
 	extractProps(e) {
 		let t = [];
-		return e.toLowerCase().includes("props") && t.push({
+		if (!e.toLowerCase().includes("props")) return t;
+		try {
+			let n = e.match(/(?:###|##)\s*Props[\s\S]*?(?=(?:###|##)\s|$)/i);
+			if (n) {
+				let e = n[0].match(/\|\s*Name\s*\|\s*Type\s*\|\s*Default\s*\|\s*Description\s*\|(?:\s*\|\s*Options\s*\|)?[\s\S]*?(?=\n\n|$)/);
+				if (e) {
+					let n = e[0].split("\n").filter((e) => e.trim().startsWith("|"));
+					for (let e = 2; e < n.length; e++) {
+						let r = n[e].split("|").map((e) => e.trim()).filter((e) => e !== "");
+						r.length >= 4 && t.push({
+							name: r[0],
+							type: r[1],
+							default: this.parseDefaultValue(r[2]),
+							description: r[3],
+							options: r[4] ? r[4].split(",").map((e) => e.trim()) : void 0
+						});
+					}
+				} else this.addDefaultProps(t);
+			} else this.addDefaultProps(t);
+		} catch (e) {
+			console.error("🔴 提取属性时出错:", e instanceof Error ? e.message : String(e)), this.addDefaultProps(t);
+		}
+		return t;
+	}
+	addDefaultProps(e) {
+		e.push({
 			name: "type",
 			type: "string",
 			default: "default",
@@ -13554,11 +13594,36 @@ var Rm = import.meta.url.slice(7), zm = t.dirname(Rm), Bm = t.join(zm, "../../pu
 			type: "boolean",
 			default: !1,
 			description: "是否禁用"
-		}), t;
+		});
+	}
+	parseDefaultValue(e) {
+		let t = e.trim();
+		if (t === "true") return !0;
+		if (t === "false") return !1;
+		if (t === "null") return null;
+		if (t === "undefined") return;
+		if (t === "[]") return [];
+		if (t === "{}") return {};
+		let n = Number(t);
+		return !isNaN(n) && t !== "" ? n : t.startsWith("\"") && t.endsWith("\"") || t.startsWith("'") && t.endsWith("'") ? t.slice(1, -1) : t;
 	}
 	extractEvents(e) {
 		let t = [];
-		return e.toLowerCase().includes("events") && t.push({
+		if (!e.toLowerCase().includes("events")) return t;
+		try {
+			let n = e.match(/(?:###|##)\s*Events[\s\S]*?(?=(?:###|##)\s|$)/i);
+			if (n) {
+				let e = n[0], r = /-\s*`(\w+)`\s*:\s*(.*?)(?=\n-|$)/g, i;
+				for (; (i = r.exec(e)) !== null;) t.push({
+					name: i[1],
+					description: i[2].trim(),
+					parameters: []
+				});
+			}
+		} catch (e) {
+			console.error("🔴 提取事件时出错:", e instanceof Error ? e.message : String(e));
+		}
+		return t.length === 0 && t.push({
 			name: "click",
 			description: "点击事件",
 			parameters: []
@@ -13566,55 +13631,85 @@ var Rm = import.meta.url.slice(7), zm = t.dirname(Rm), Bm = t.join(zm, "../../pu
 	}
 	extractSlots(e) {
 		let t = [];
-		return e.toLowerCase().includes("slots") && t.push({
+		if (!e.toLowerCase().includes("slots")) return t;
+		try {
+			let n = e.match(/(?:###|##)\s*Slots[\s\S]*?(?=(?:###|##)\s|$)/i);
+			if (n) {
+				let e = n[0], r = /-\s*`(\w+)`\s*:\s*(.*?)(?=\n-|$)/g, i;
+				for (; (i = r.exec(e)) !== null;) t.push({
+					name: i[1],
+					description: i[2].trim(),
+					default: i[1] === "default"
+				});
+			}
+		} catch (e) {
+			console.error("🔴 提取插槽时出错:", e instanceof Error ? e.message : String(e));
+		}
+		return t.length === 0 && t.push({
 			name: "default",
 			description: "默认插槽",
 			default: !0
 		}), t;
 	}
 	extractUsage(e) {
-		let t = e.match(/```[\s\S]*?```/);
-		return t ? t[0].replace(/```/g, "").trim() : `<${this.capitalizeFirstLetter(e.split(" ")[0] || "Component")} />`;
+		try {
+			let t = e.match(/```(vue|html|jsx)?[\s\S]*?```/);
+			if (t) return t[0].replace(/```(vue|html|jsx)?|```/g, "").trim();
+		} catch (e) {
+			console.error("🔴 提取使用示例时出错:", e instanceof Error ? e.message : String(e));
+		}
+		return `<${this.capitalizeFirstLetter(e.split(" ")[0] || "Component")} />`;
 	}
 	extractExamples(e) {
-		let t = [], n = e.match(/```[\s\S]*?```/g) || [];
-		return n.length > 0 && t.push({
-			title: "Basic Usage",
-			code: n[0].replace(/```/g, "").trim()
-		}), n.length > 1 && t.push({
-			title: "Advanced Usage",
-			code: n[1].replace(/```/g, "").trim()
-		}), t;
+		let t = [];
+		try {
+			let n = e.match(/```(vue|html|jsx)?[\s\S]*?```/g) || [];
+			n.length > 0 && t.push({
+				title: "Basic Usage",
+				code: n[0].replace(/```(vue|html|jsx)?|```/g, "").trim()
+			}), n.length > 1 && t.push({
+				title: "Advanced Usage",
+				code: n[1].replace(/```(vue|html|jsx)?|```/g, "").trim()
+			});
+		} catch (e) {
+			console.error("🔴 提取示例代码时出错:", e instanceof Error ? e.message : String(e));
+		}
+		return t;
 	}
 	capitalizeFirstLetter(e) {
 		return e.charAt(0).toUpperCase() + e.slice(1);
 	}
 	getComponentDetails(n) {
-		let r = "", i = "";
-		if (this.traverseDocs((e, t, a) => {
-			t.toLowerCase() === n.toLowerCase() && (r = a, i = e);
-		}), !r) return null;
-		let a = "", o = "";
+		let r = n.toLowerCase();
+		if (this.componentDetailsCache.has(r)) return console.log(`✅ 从缓存中获取组件 ${n} 的详情`), this.componentDetailsCache.get(r);
+		console.log(`🔍 正在查找组件 ${n}...`);
+		let i = "", a = "";
+		if (this.traverseDocs((e, t, r) => {
+			t.toLowerCase() === n.toLowerCase() && (i = r, a = e);
+		}), !i) return console.warn(`❌ 未找到组件 ${n}`), null;
+		let o = "", s = "";
 		try {
-			let n = t.join(r, "Document.vue");
-			e.existsSync(n) && (o = e.readFileSync(n, "utf-8"), a = this.extractMarkdownFromVue(o));
+			let n = t.join(i, "Document.vue");
+			e.existsSync(n) && (console.log(`📄 正在读取组件文档: ${n}`), s = e.readFileSync(n, "utf-8"), o = this.extractMarkdownFromVue(s));
 		} catch (e) {
-			console.error("读取组件文档时出错:", e);
+			console.error("🔴 读取组件文档时出错:", e instanceof Error ? e.message : String(e));
 		}
-		return {
+		let c = {
 			name: n,
-			category: i,
+			category: a,
 			description: `${n} component for Exploria UI`,
-			path: r,
-			documentContent: a,
-			props: this.extractProps(a),
-			events: this.extractEvents(a),
-			slots: this.extractSlots(a),
-			usage: this.extractUsage(a),
-			examples: this.extractExamples(a)
+			path: i,
+			documentContent: o,
+			props: this.extractProps(o),
+			events: this.extractEvents(o),
+			slots: this.extractSlots(o),
+			usage: this.extractUsage(o),
+			examples: this.extractExamples(o)
 		};
+		return this.componentDetailsCache.set(r, c), console.log(`✅ 成功获取组件 ${n} 的详情`), c;
 	}
 	searchDocuments(e) {
+		console.log(`🔍 正在搜索文档: ${e}`);
 		let t = [], n = e.toLowerCase();
 		return this.traverseDocs((e, r, i) => {
 			let a = r.toLowerCase(), o = e.toLowerCase(), s = "low";
@@ -13631,14 +13726,17 @@ var Rm = import.meta.url.slice(7), zm = t.dirname(Rm), Bm = t.join(zm, "../../pu
 				low: 1
 			};
 			return n[t.relevance] - n[e.relevance];
-		}), t;
+		}), console.log(`✅ 搜索完成，共找到 ${t.length} 个匹配结果`), t;
+	}
+	clearCache() {
+		this.componentListCache = null, this.componentDetailsCache.clear(), console.log("🗑️  已清空文档解析器缓存");
 	}
 }();
 //#endregion
 //#region src/resources/componentList.ts
-function Hm(e) {
+function Rm(e) {
 	e.resource("component_list", "components://exploria-ui-list", async (e) => {
-		let t = Vm.getComponentList();
+		let t = Lm.getComponentList();
 		return { contents: [{
 			uri: e.href,
 			text: JSON.stringify({
@@ -13652,9 +13750,8 @@ function Hm(e) {
 }
 //#endregion
 //#region src/resources/serverStatus.ts
-var Um = import.meta.url.slice(7), Wm = t.dirname(Um);
-function Gm(n) {
-	let r = t.join(Wm, "../../package.json"), i = JSON.parse(e.readFileSync(r, "utf-8"));
+function zm(n) {
+	let r = t.join(process.cwd(), "package.json"), i = JSON.parse(e.readFileSync(r, "utf-8"));
 	n.resource("server_status", "status://exploria-ui-server", async (e) => ({ contents: [{
 		uri: e.href,
 		text: JSON.stringify({
@@ -13670,15 +13767,15 @@ function Gm(n) {
 }
 //#endregion
 //#region src/resources/index.ts
-function Km(e) {
-	Gm(e), Lm(e), Hm(e);
+function Bm(e) {
+	console.log("📚 正在注册 MCP 资源..."), zm(e), Fm(e), Rm(e), console.log("✅ 所有 MCP 资源注册完成");
 }
 //#endregion
 //#region src/tools/getComponentDetails.ts
-function qm(e) {
+function Vm(e) {
 	e.tool("get_component_details", "获取指定 Exploria UI 组件的详细信息", { componentName: r.string().describe("组件名称，例如：button、input、dialog") }, async ({ componentName: e }) => {
 		try {
-			let t = Vm.getComponentDetails(e);
+			let t = Lm.getComponentDetails(e);
 			return t ? { content: [{
 				type: "text",
 				text: JSON.stringify({
@@ -13708,10 +13805,10 @@ function qm(e) {
 }
 //#endregion
 //#region src/tools/getComponentList.ts
-function Jm(e) {
+function Hm(e) {
 	e.tool("get_component_list", "获取所有 Exploria UI 组件列表", {}, async () => {
 		try {
-			let e = Vm.getComponentList();
+			let e = Lm.getComponentList();
 			return { content: [{
 				type: "text",
 				text: JSON.stringify({
@@ -13733,13 +13830,13 @@ function Jm(e) {
 }
 //#endregion
 //#region src/tools/searchAndGetDetails.ts
-function Ym(e) {
+function Um(e) {
 	e.tool("search_and_get_details", "搜索 Exploria UI 组件并获取详细信息", {
 		query: r.string().describe("搜索关键词，例如：button、input、dialog"),
 		limit: r.number().optional().describe("返回结果数量限制，默认为 3")
 	}, async ({ query: e, limit: t = 3 }) => {
 		try {
-			let n = Vm.searchDocuments(e);
+			let n = Lm.searchDocuments(e);
 			if (n.length === 0) return { content: [{
 				type: "text",
 				text: JSON.stringify({
@@ -13748,7 +13845,7 @@ function Ym(e) {
 				}, null, 2)
 			}] };
 			let r = await Promise.all(n.slice(0, t).map(async (e) => {
-				let t = Vm.getComponentDetails(e.name);
+				let t = Lm.getComponentDetails(e.name);
 				return {
 					...e,
 					details: t
@@ -13775,10 +13872,10 @@ function Ym(e) {
 }
 //#endregion
 //#region src/tools/searchDocuments.ts
-function Xm(e) {
+function Wm(e) {
 	e.tool("search_documents", "搜索 Exploria UI 组件文档", { query: r.string().describe("搜索关键词，例如：button、input、dialog") }, async ({ query: e }) => {
 		try {
-			let t = Vm.searchDocuments(e);
+			let t = Lm.searchDocuments(e);
 			return { content: [{
 				type: "text",
 				text: JSON.stringify({
@@ -13799,27 +13896,66 @@ function Xm(e) {
 }
 //#endregion
 //#region src/tools/index.ts
-function Zm(e) {
-	Xm(e), Jm(e), qm(e), Ym(e);
+function Gm(e) {
+	console.log("🔧 正在注册 MCP 工具..."), Wm(e), Hm(e), Vm(e), Um(e), console.log("✅ 所有 MCP 工具注册完成");
 }
-//#endregion
-//#region src/index.ts
-var Qm = import.meta.url.slice(7), $m = t.dirname(Qm), eh = t.join($m, "../package.json"), th = JSON.parse(e.readFileSync(eh, "utf-8")), nh = new _m({
-	name: th.name,
-	version: th.version,
-	description: th.description
-});
-Zm(nh), Km(nh), Pm(nh), process.stdin.on("error", (e) => {
-	console.error("标准输入错误:", e), process.exit(1);
-}), process.stdout.on("error", (e) => {
-	console.error("标准输出错误:", e), process.exit(1);
-}), process.on("SIGINT", async () => {
-	await nh.close(), console.log("MCP Server 已关闭"), process.exit(0);
-});
-var rh = new jm();
-nh.connect(rh).then(() => {
-	console.log("Exploria UI MCP Server 已启动，等待连接..."), console.log(`Server name: ${th.name}`), console.log(`Server version: ${th.version}`);
-}).catch((e) => {
-	console.error("启动 MCP Server 失败:", e), process.exit(1);
-});
+new class {
+	server = null;
+	packageJson;
+	transport = null;
+	constructor() {
+		this.loadPackageJson(), this.setupEventHandlers();
+	}
+	loadPackageJson() {
+		try {
+			let n = t.join(process.cwd(), "package.json"), r = e.readFileSync(n, "utf-8");
+			this.packageJson = JSON.parse(r);
+		} 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.log("\n🟠 收到 SIGINT 信号，正在关闭服务器..."), this.shutdown(0);
+		}), process.on("SIGTERM", () => {
+			console.log("\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 {
+			this.server = new _m({
+				name: this.packageJson.name,
+				version: this.packageJson.version,
+				description: this.packageJson.description
+			}), Gm(this.server), Bm(this.server), Pm(this.server), console.log("🟢 成功注册所有工具、资源和提示");
+		} catch (e) {
+			console.error("🔴 初始化 MCP Server 失败:", e), process.exit(1);
+		}
+	}
+	async start() {
+		try {
+			if (this.initializeServer(), this.transport = new jm(), !this.server || !this.transport) throw Error("服务器或传输层未初始化");
+			await this.server.connect(this.transport), console.log("\n✅ Exploria UI MCP Server 已成功启动"), console.log(`📦 服务器名称: ${this.packageJson.name}`), console.log(`📌 服务器版本: ${this.packageJson.version}`), console.log("🔗 等待 AI IDE 连接...\n");
+		} catch (e) {
+			console.error("🔴 启动 MCP Server 失败:", e), this.shutdown(1);
+		}
+	}
+	async shutdown(e) {
+		try {
+			this.server && (await this.server.close(), console.log("✅ MCP Server 已成功关闭"));
+		} catch (e) {
+			console.error("🔴 关闭服务器时发生错误:", e);
+		} finally {
+			process.exit(e);
+		}
+	}
+}().start();
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exploria-ui-mcp-server",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "MCP Server for Exploria UI Component Library",
   "main": "dist/index.js",
   "type": "module",