customs-ui-kit-mcp 1.0.0

package/dist/index.js

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// 动态解析 UI package 路径
+// 当作为 npm 包全局安装时，尝试在 node_modules 中寻找 customs-ui-kit
+function getUiPackagePath() {
+    // 1. 本地开发环境路径 (Monorepo)
+    const localPath = path.resolve(__dirname, "../../ui/src/components");
+    if (fs.existsSync(localPath)) {
+        return localPath;
+    }
+    // 2. 作为 npm 包安装后的路径 (寻找兄弟依赖 customs-ui-kit)
+    try {
+        const uiPkgPath = require.resolve("customs-ui-kit/package.json");
+        // 假设发布时将 src 也打包进去了，或者直接读取 dist/types
+        // 为了简单起见，我们假设团队成员也会安装 customs-ui-kit 到他们的项目中
+        // 我们需要读取的是组件的元数据。
+        // 这里我们先尝试找项目根目录下的 node_modules/customs-ui-kit/src/components
+        const resolvedPath = path.join(path.dirname(uiPkgPath), "src/components");
+        if (fs.existsSync(resolvedPath)) {
+            return resolvedPath;
+        }
+    }
+    catch (e) {
+        // 忽略错误
+    }
+    // 3. 如果找不到，返回一个默认路径防止报错崩溃
+    return localPath;
+}
+const UI_PACKAGE_PATH = getUiPackagePath();
+const server = new index_js_1.Server({
+    name: "customs-ui-kit-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// 获取组件列表
+function getComponents() {
+    if (!fs.existsSync(UI_PACKAGE_PATH))
+        return [];
+    return fs.readdirSync(UI_PACKAGE_PATH).filter((file) => {
+        return fs.statSync(path.join(UI_PACKAGE_PATH, file)).isDirectory();
+    });
+}
+// 获取组件 API (读取 Vue 文件或 ts 文件的 Props 定义)
+function getComponentApi(componentName) {
+    const compPath = path.join(UI_PACKAGE_PATH, componentName, `${componentName}.vue`);
+    if (!fs.existsSync(compPath)) {
+        return `Component ${componentName} not found.`;
+    }
+    const content = fs.readFileSync(compPath, "utf-8");
+    // 简单提取 script setup 里的类型定义部分
+    const scriptMatch = content.match(/<script setup lang="ts">([\s\S]*?)<\/script>/);
+    if (scriptMatch && scriptMatch[1]) {
+        return scriptMatch[1].trim();
+    }
+    return "No TypeScript API definition found.";
+}
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "list_components",
+                description: "List all available components in the Customs UI Kit",
+                inputSchema: {
+                    type: "object",
+                    properties: {},
+                },
+            },
+            {
+                name: "get_component_api",
+                description: "Get the TypeScript Props API and JSDoc for a specific component",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        componentName: {
+                            type: "string",
+                            description: "The name of the component (e.g., Button, Table)",
+                        },
+                    },
+                    required: ["componentName"],
+                },
+            },
+            {
+                name: "get_component_examples",
+                description: "Get usage examples for a specific component from Storybook",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        componentName: {
+                            type: "string",
+                            description: "The name of the component (e.g., Button, Table)",
+                        },
+                    },
+                    required: ["componentName"],
+                },
+            },
+        ],
+    };
+});
+// 获取组件示例 (读取 Storybook 文件)
+function getComponentExamples(componentName) {
+    const storyPath = path.join(UI_PACKAGE_PATH, componentName, `${componentName}.stories.ts`);
+    if (!fs.existsSync(storyPath)) {
+        return `No examples found for component ${componentName}.`;
+    }
+    return fs.readFileSync(storyPath, "utf-8");
+}
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    if (request.params.name === "list_components") {
+        const components = getComponents();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(components, null, 2),
+                },
+            ],
+        };
+    }
+    if (request.params.name === "get_component_api") {
+        const componentName = request.params.arguments?.componentName;
+        if (!componentName) {
+            throw new Error("componentName is required");
+        }
+        const api = getComponentApi(componentName);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: api,
+                },
+            ],
+        };
+    }
+    if (request.params.name === "get_component_examples") {
+        const componentName = request.params.arguments?.componentName;
+        if (!componentName) {
+            throw new Error("componentName is required");
+        }
+        const examples = getComponentExamples(componentName);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: examples,
+                },
+            ],
+        };
+    }
+    throw new Error(`Unknown tool: ${request.params.name}`);
+});
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Customs UI Kit MCP Server running on stdio");
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "customs-ui-kit-mcp",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "bin": {
+    "customs-ui-kit-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "@storybook/addon-essentials": "^8.6.14",
+    "@storybook/addon-interactions": "^8.6.14",
+    "@storybook/addon-links": "^10.2.17",
+    "@storybook/blocks": "^8.6.14",
+    "@storybook/vue3": "^10.2.17",
+    "@storybook/vue3-vite": "^10.2.17",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.4.0",
+    "storybook": "^10.2.17",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}