@sdata/web-vue-mcp 1.13.0 → 1.15.0

package/README.md

@@ -6,7 +6,9 @@
 
 [MCP](https://modelcontextprotocol.io/) 是一个让 AI 模型连接外部工具与数据源的开放协议。本服务把 SD Design 组件库的 API 元数据暴露给 AI 助手，使其在编码时无需盲猜组件 Props，而是基于组件库真实导出的接口回答。
 
-数据来源与组件库对外发布的 `web-types` / `vetur` IDE 元数据一致（均由 [`vue-docgen-api`](https://github.com/vue-styleguidist/vue-docgen) 从组件源码提取），覆盖 85 个文档化组件。
+服务基于 MCP TypeScript SDK v2，支持当前的 `2026-07-28` 协议，并继续兼容使用 `initialize` 握手的旧版客户端。
+
+数据来源与组件库对外发布的 `web-types` / `vetur` IDE 元数据一致（均由 [`vue-docgen-api`](https://github.com/vue-styleguidist/vue-docgen) 从组件源码提取），覆盖全部文档化组件。
 
 ## 安装
 
@@ -117,6 +119,9 @@ pnpm --filter @sdata/web-vue-mcp run build
 
 # 类型检查
 pnpm --filter @sdata/web-vue-mcp run typecheck
+
+# 构建后分别以 2026-07-28 和旧版协议运行 stdio 集成测试
+pnpm --filter @sdata/web-vue-mcp run test
 ```
 
 ## 可用工具

package/dist/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { McpServer } from "@modelcontextprotocol/server";
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+import * as z from "zod/v4";
 //#endregion
 //#region src/index.ts
 const data = {
-	version: "3.24.1",
-	generatedAt: "2026-07-30T02:31:45.857Z",
+	version: "3.26.0",
+	generatedAt: "2026-08-05T06:12:16.712Z",
 	library: {
 		"name": "@sdata/web-vue",
 		"framework": "Vue 3",
@@ -6300,6 +6300,64 @@ const data = {
 				}
 			]
 		},
+		{
+			"name": "sd-thinking-orb",
+			"title": "思考球 ThinkingOrb",
+			"category": "反馈",
+			"description": "为 AI、智能体和异步推理场景提供语义明确的点阵思考动效。",
+			"docUrl": "https://sd-design.js.org/components/thinking-orb",
+			"importPath": "@sdata/web-vue",
+			"importName": "ThinkingOrb",
+			"props": [
+				{
+					"name": "state",
+					"type": "ThinkingOrbState",
+					"default": "",
+					"description": {
+						"zh": "当前思考状态",
+						"en": "Current thinking state"
+					}
+				},
+				{
+					"name": "size",
+					"type": "ThinkingOrbSize",
+					"default": "",
+					"description": {
+						"zh": "针对使用场景调优的尺寸",
+						"en": "Purpose-tuned rendered size"
+					}
+				},
+				{
+					"name": "theme",
+					"type": "ThinkingOrbTheme",
+					"default": "",
+					"description": {
+						"zh": "主题模式，auto 跟随最近的 sd-theme 容器",
+						"en": "Theme mode; auto follows the nearest sd-theme container"
+					}
+				},
+				{
+					"name": "speed",
+					"type": "number",
+					"default": "",
+					"description": {
+						"zh": "动画速度倍率",
+						"en": "Animation speed multiplier"
+					}
+				},
+				{
+					"name": "paused",
+					"type": "boolean",
+					"default": "",
+					"description": {
+						"zh": "是否暂停动画",
+						"en": "Whether the animation is paused"
+					}
+				}
+			],
+			"events": [],
+			"slots": []
+		},
 		{
 			"name": "sd-tour",
 			"title": "漫游式引导 Tour",
@@ -11636,7 +11694,6 @@ const data = {
 const components = data.components;
 const library = data.library;
 const PKG_NAME = "@sdata/web-vue-mcp";
-const PKG_VERSION = "0.1.0";
 const normalizeKey = (value) => value.toLowerCase().trim().replace(/^sd-/, "");
 const byKey = /* @__PURE__ */ new Map();
 for (const component of components) {
@@ -11678,99 +11735,6 @@ const importStatements = (component) => ({
 		`app.use(SDVue);`
 	].join("\n")
 });
-const tools = [
-	{
-		name: "list_components",
-		description: "List all SD Design components with their category, bilingual title and API size. Optionally filter by category. Use this first to discover what is available.",
-		inputSchema: {
-			type: "object",
-			properties: { category: {
-				type: "string",
-				description: "Optional category filter, e.g. 通用 / 布局 / 导航 / 数据展示 / 反馈 / 其他."
-			} }
-		}
-	},
-	{
-		name: "get_categories",
-		description: "List all SD Design component categories with the number of components in each.",
-		inputSchema: {
-			type: "object",
-			properties: {}
-		}
-	},
-	{
-		name: "get_component",
-		description: "Get full detail for a component: description, import statements, documentation URL, and every documented prop, event and slot (bilingual zh/en). Accepts the tag (sd-button), kebab (button) or PascalCase (Button) name.",
-		inputSchema: {
-			type: "object",
-			properties: { name: {
-				type: "string",
-				description: "Component name, e.g. \"sd-button\", \"button\" or \"Button\"."
-			} },
-			required: ["name"]
-		}
-	},
-	{
-		name: "search_components",
-		description: "Search components by keyword across name, title, description and prop/event/slot text (both Chinese and English). Returns matching components with the fields that matched.",
-		inputSchema: {
-			type: "object",
-			properties: { query: {
-				type: "string",
-				description: "Search keyword, e.g. \"日期\", \"tree\", \"上传\"."
-			} },
-			required: ["query"]
-		}
-	},
-	{
-		name: "get_component_props",
-		description: "Get only the documented props for a component (name, type, default, bilingual description).",
-		inputSchema: {
-			type: "object",
-			properties: { name: {
-				type: "string",
-				description: "Component name."
-			} },
-			required: ["name"]
-		}
-	},
-	{
-		name: "get_component_events",
-		description: "Get only the documented events for a component (name and bilingual description).",
-		inputSchema: {
-			type: "object",
-			properties: { name: {
-				type: "string",
-				description: "Component name."
-			} },
-			required: ["name"]
-		}
-	},
-	{
-		name: "get_component_slots",
-		description: "Get only the documented slots for a component (name and bilingual description).",
-		inputSchema: {
-			type: "object",
-			properties: { name: {
-				type: "string",
-				description: "Component name."
-			} },
-			required: ["name"]
-		}
-	},
-	{
-		name: "find_by_prop",
-		description: "Find components that expose a given prop. Useful for \"which components have a size prop?\" or \"what can I set disabled on?\".",
-		inputSchema: {
-			type: "object",
-			properties: { prop: {
-				type: "string",
-				description: "Prop name to search for, e.g. \"size\", \"disabled\"."
-			} },
-			required: ["prop"]
-		}
-	}
-];
 const search = (query) => {
 	const needle = query.toLowerCase().trim();
 	if (!needle) return [];
@@ -11824,94 +11788,112 @@ const findByProp = (prop) => {
 	}
 	return results;
 };
-const server = new Server({
-	name: PKG_NAME,
-	version: PKG_VERSION
-}, { capabilities: { tools: {} } });
-server.setRequestHandler(ListToolsRequestSchema, () => ({ tools }));
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-	const { name, arguments: args = {} } = request.params;
-	switch (name) {
-		case "list_components": {
-			const category = args?.category?.trim();
-			const list = category ? components.filter((component) => component.category === category) : components;
-			return result({
-				total: list.length,
-				...category ? { category } : {},
-				library: library.name,
-				version: data.version,
-				components: list.map(summary)
-			});
-		}
-		case "get_categories": {
-			const counts = data.categories.map((category) => ({
-				category,
-				count: components.filter((component) => component.category === category).length
-			}));
-			return result({
-				total: components.length,
-				categories: counts
-			});
-		}
-		case "get_component": {
-			const component = findComponent(args?.name);
-			if (!component) return notFound(args?.name ?? "");
-			return result({
-				...summary(component),
-				import: importStatements(component),
-				props: component.props,
-				events: component.events,
-				slots: component.slots
-			});
-		}
-		case "search_components": {
-			const query = args?.query ?? "";
-			const matches = search(query);
-			return result({
-				query,
-				total: matches.length,
-				matches
-			});
-		}
-		case "get_component_props": {
-			const component = findComponent(args?.name);
-			if (!component) return notFound(args?.name ?? "");
-			return result({
-				name: component.name,
-				title: component.title,
-				props: component.props
-			});
-		}
-		case "get_component_events": {
-			const component = findComponent(args?.name);
-			if (!component) return notFound(args?.name ?? "");
-			return result({
-				name: component.name,
-				title: component.title,
-				events: component.events
-			});
-		}
-		case "get_component_slots": {
-			const component = findComponent(args?.name);
-			if (!component) return notFound(args?.name ?? "");
-			return result({
-				name: component.name,
-				title: component.title,
-				slots: component.slots
-			});
-		}
-		case "find_by_prop": {
-			const prop = args?.prop ?? "";
-			const results = findByProp(prop);
-			return result({
-				prop,
-				total: results.length,
-				results
-			});
-		}
-		default: return result({ error: `Unknown tool: ${name}` });
-	}
-});
-await server.connect(new StdioServerTransport());
+const createServer = () => {
+	const server = new McpServer({
+		name: PKG_NAME,
+		version: "1.15.0"
+	});
+	server.registerTool("list_components", {
+		description: "List all SD Design components with their category, bilingual title and API size. Optionally filter by category. Use this first to discover what is available.",
+		inputSchema: z.object({ category: z.string().optional().describe("Optional category filter, e.g. 通用 / 布局 / 导航 / 数据展示 / 反馈 / 其他.") })
+	}, ({ category }) => {
+		const normalizedCategory = category?.trim();
+		const list = normalizedCategory ? components.filter((component) => component.category === normalizedCategory) : components;
+		return result({
+			total: list.length,
+			...normalizedCategory ? { category: normalizedCategory } : {},
+			library: library.name,
+			version: data.version,
+			components: list.map(summary)
+		});
+	});
+	server.registerTool("get_categories", {
+		description: "List all SD Design component categories with the number of components in each.",
+		inputSchema: z.object({})
+	}, () => {
+		const counts = data.categories.map((category) => ({
+			category,
+			count: components.filter((component) => component.category === category).length
+		}));
+		return result({
+			total: components.length,
+			categories: counts
+		});
+	});
+	server.registerTool("get_component", {
+		description: "Get full detail for a component: description, import statements, documentation URL, and every documented prop, event and slot (bilingual zh/en). Accepts the tag (sd-button), kebab (button) or PascalCase (Button) name.",
+		inputSchema: z.object({ name: z.string().describe("Component name, e.g. \"sd-button\", \"button\" or \"Button\".") })
+	}, ({ name }) => {
+		const component = findComponent(name);
+		if (!component) return notFound(name);
+		return result({
+			...summary(component),
+			import: importStatements(component),
+			props: component.props,
+			events: component.events,
+			slots: component.slots
+		});
+	});
+	server.registerTool("search_components", {
+		description: "Search components by keyword across name, title, description and prop/event/slot text (both Chinese and English). Returns matching components with the fields that matched.",
+		inputSchema: z.object({ query: z.string().describe("Search keyword, e.g. \"日期\", \"tree\", \"上传\".") })
+	}, ({ query }) => {
+		const matches = search(query);
+		return result({
+			query,
+			total: matches.length,
+			matches
+		});
+	});
+	server.registerTool("get_component_props", {
+		description: "Get only the documented props for a component (name, type, default, bilingual description).",
+		inputSchema: z.object({ name: z.string().describe("Component name.") })
+	}, ({ name }) => {
+		const component = findComponent(name);
+		if (!component) return notFound(name);
+		return result({
+			name: component.name,
+			title: component.title,
+			props: component.props
+		});
+	});
+	server.registerTool("get_component_events", {
+		description: "Get only the documented events for a component (name and bilingual description).",
+		inputSchema: z.object({ name: z.string().describe("Component name.") })
+	}, ({ name }) => {
+		const component = findComponent(name);
+		if (!component) return notFound(name);
+		return result({
+			name: component.name,
+			title: component.title,
+			events: component.events
+		});
+	});
+	server.registerTool("get_component_slots", {
+		description: "Get only the documented slots for a component (name and bilingual description).",
+		inputSchema: z.object({ name: z.string().describe("Component name.") })
+	}, ({ name }) => {
+		const component = findComponent(name);
+		if (!component) return notFound(name);
+		return result({
+			name: component.name,
+			title: component.title,
+			slots: component.slots
+		});
+	});
+	server.registerTool("find_by_prop", {
+		description: "Find components that expose a given prop. Useful for \"which components have a size prop?\" or \"what can I set disabled on?\".",
+		inputSchema: z.object({ prop: z.string().describe("Prop name to search for, e.g. \"size\", \"disabled\".") })
+	}, ({ prop }) => {
+		const results = findByProp(prop);
+		return result({
+			prop,
+			total: results.length,
+			results
+		});
+	});
+	return server;
+};
+serveStdio(createServer);
 //#endregion
 export {};

package/package.json

@@ -44,10 +44,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0"
+    "@modelcontextprotocol/server": "2.0.0",
+    "zod": "4.4.3"
   },
   "devDependencies": {
     "@babel/types": "^7.29.7",
+    "@modelcontextprotocol/client": "2.0.0",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/github": "^12.0.9",
@@ -62,10 +64,11 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "1.13.0",
+  "version": "1.15.0",
   "scripts": {
     "gen": "node ./scripts/gen-component-data.mjs",
-    "build": "pnpm run gen && tsdown",
+    "build": "node ./scripts/build.mjs",
+    "test": "node ./scripts/build.mjs 9.8.7-test && node --test ./test/*.test.mjs",
     "typecheck": "pnpm run gen && tsc --noEmit",
     "dev:link": "pnpm link --global && npm link"
   }