pda-kit-mcp-server 2.0.1

package/dist/tools/list-components.js

@@ -0,0 +1,104 @@
+/**
+ * Tool: list_components
+ *
+ * 列出所有可用的 PDA Kit 组件
+ */
+import { readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+// 获取规范数据目录
+function getSpecDir() {
+    if (process.env.PDA_KIT_SPEC_PATH) {
+        return process.env.PDA_KIT_SPEC_PATH;
+    }
+    return join(__dirname, '../../../..', 'PDAKit-规范', 'components');
+}
+export const listComponentsTool = {
+    name: 'list_components',
+    description: '列出 PDA Kit 中所有可用的组件及其基本信息',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            category: {
+                type: 'string',
+                enum: ['all', 'atom', 'molecule', 'organism', 'business'],
+                description: '组件类别筛选',
+                default: 'all',
+            },
+        },
+    },
+    handler: async (args) => {
+        const { category = 'all' } = args;
+        const componentsDir = getSpecDir();
+        try {
+            const files = readdirSync(componentsDir);
+            const mdFiles = files.filter((f) => f.endsWith('.md'));
+            const components = mdFiles.map((file) => {
+                const name = file.replace('.md', '');
+                const content = readFileSync(join(componentsDir, file), 'utf-8');
+                // 解析 frontmatter
+                const frontmatter = parseFrontmatter(content);
+                return {
+                    name,
+                    displayName: frontmatter.name || name,
+                    category: frontmatter.category || 'unknown',
+                    version: frontmatter.version || '1.0',
+                    description: frontmatter.description || extractDescription(content),
+                };
+            });
+            // 按类别筛选
+            const filtered = category === 'all'
+                ? components
+                : components.filter((c) => c.category.toLowerCase().includes(category.toLowerCase()));
+            // 按类别分组
+            const grouped = filtered.reduce((acc, comp) => {
+                const cat = comp.category || '其他';
+                if (!acc[cat])
+                    acc[cat] = [];
+                acc[cat].push(comp);
+                return acc;
+            }, {});
+            return {
+                success: true,
+                total: filtered.length,
+                category,
+                grouped,
+                components: filtered,
+                hint: '使用 get_component_spec 查看组件详细规范',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: '读取组件列表失败: ' + (error instanceof Error ? error.message : String(error)),
+            };
+        }
+    },
+};
+// 解析 frontmatter
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const frontmatter = {};
+    const lines = match[1].split('\n');
+    for (const line of lines) {
+        const colonIndex = line.indexOf(':');
+        if (colonIndex > 0) {
+            const key = line.slice(0, colonIndex).trim();
+            const value = line.slice(colonIndex + 1).trim().replace(/^["']|["']$/g, '');
+            frontmatter[key] = value;
+        }
+    }
+    return frontmatter;
+}
+// 提取描述
+function extractDescription(content) {
+    // 移除 frontmatter
+    const noFrontmatter = content.replace(/^---\n[\s\S]*?\n---/, '');
+    // 获取第一段
+    const firstParagraph = noFrontmatter.trim().split('\n\n')[0];
+    return firstParagraph.slice(0, 100) + (firstParagraph.length > 100 ? '...' : '');
+}
+//# sourceMappingURL=list-components.js.map

package/dist/tools/list-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-components.js","sourceRoot":"","sources":["../../src/tools/list-components.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,WAAW;AACX,SAAS,UAAU;IACjB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,2BAA2B;IACxC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC;gBACzD,WAAW,EAAE,QAAQ;gBACrB,OAAO,EAAE,KAAK;aACf;SACF;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAA2B,EAAE,EAAE;QAC7C,MAAM,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAElC,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAEvD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACrC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBAEjE,iBAAiB;gBACjB,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBAE9C,OAAO;oBACL,IAAI;oBACJ,WAAW,EAAE,WAAW,CAAC,IAAI,IAAI,IAAI;oBACrC,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,SAAS;oBAC3C,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,KAAK;oBACrC,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,kBAAkB,CAAC,OAAO,CAAC;iBACpE,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,QAAQ;YACR,MAAM,QAAQ,GACZ,QAAQ,KAAK,KAAK;gBAChB,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;YAE1F,QAAQ;YACR,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;gBAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;gBAClC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;gBAC7B,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,OAAO,GAAG,CAAC;YACb,CAAC,EAAE,EAAuC,CAAC,CAAC;YAE5C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,QAAQ,CAAC,MAAM;gBACtB,QAAQ;gBACR,OAAO;gBACP,UAAU,EAAE,QAAQ;gBACpB,IAAI,EAAE,gCAAgC;aACvC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;aAC/E,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,iBAAiB;AACjB,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YAC5E,WAAW,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,OAAO;AACP,SAAS,kBAAkB,CAAC,OAAe;IACzC,iBAAiB;IACjB,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACjE,QAAQ;IACR,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC"}

package/dist/tools/search-components.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Tool: search_components
+ *
+ * 搜索组件
+ */
+export declare const searchComponentsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            keyword: {
+                type: string;
+                description: string;
+            };
+            searchIn: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+                default: string[];
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        keyword: string;
+        searchIn?: string[];
+    }) => Promise<{
+        success: boolean;
+        keyword: string;
+        total: number;
+        results: {
+            name: string;
+            displayName: string;
+            category: string;
+            version: string;
+            matchReason: string;
+            snippet: string;
+        }[];
+        hint: string;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: string;
+        keyword?: undefined;
+        total?: undefined;
+        results?: undefined;
+        hint?: undefined;
+    }>;
+};
+//# sourceMappingURL=search-components.d.ts.map

package/dist/tools/search-components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-components.d.ts","sourceRoot":"","sources":["../../src/tools/search-components.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;oBAsBT;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;CAwE/D,CAAC"}

package/dist/tools/search-components.js

@@ -0,0 +1,124 @@
+/**
+ * Tool: search_components
+ *
+ * 搜索组件
+ */
+import { readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+export const searchComponentsTool = {
+    name: 'search_components',
+    description: '根据关键词搜索 PDA Kit 组件',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            keyword: {
+                type: 'string',
+                description: '搜索关键词',
+            },
+            searchIn: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: ['name', 'description', 'content'],
+                },
+                description: '搜索范围',
+                default: ['name', 'description'],
+            },
+        },
+        required: ['keyword'],
+    },
+    handler: async (args) => {
+        const { keyword, searchIn = ['name', 'description'] } = args;
+        const lowerKeyword = keyword.toLowerCase();
+        // 获取 PDA Kit 根目录
+        const pdaKitRoot = process.env.PDA_KIT_ROOT || join(__dirname, '../../..');
+        const componentsDir = join(pdaKitRoot, 'PDAKit-规范', 'components');
+        try {
+            const files = readdirSync(componentsDir);
+            const mdFiles = files.filter((f) => f.endsWith('.md'));
+            const results = [];
+            for (const file of mdFiles) {
+                const name = file.replace('.md', '');
+                const content = readFileSync(join(componentsDir, file), 'utf-8');
+                let match = false;
+                let matchReason = '';
+                // 搜索名称
+                if (searchIn.includes('name') && name.toLowerCase().includes(lowerKeyword)) {
+                    match = true;
+                    matchReason = '名称匹配';
+                }
+                // 搜索描述
+                if (!match && searchIn.includes('description')) {
+                    const frontmatter = parseFrontmatter(content);
+                    const description = frontmatter.name || '';
+                    if (description.toLowerCase().includes(lowerKeyword)) {
+                        match = true;
+                        matchReason = '描述匹配';
+                    }
+                }
+                // 搜索内容
+                if (!match && searchIn.includes('content')) {
+                    if (content.toLowerCase().includes(lowerKeyword)) {
+                        match = true;
+                        matchReason = '内容匹配';
+                    }
+                }
+                if (match) {
+                    const frontmatter = parseFrontmatter(content);
+                    results.push({
+                        name,
+                        displayName: frontmatter.name || name,
+                        category: frontmatter.category || 'unknown',
+                        version: frontmatter.version || '1.0',
+                        matchReason,
+                        snippet: extractSnippet(content, keyword),
+                    });
+                }
+            }
+            return {
+                success: true,
+                keyword,
+                total: results.length,
+                results,
+                hint: results.length > 0 ? '使用 get_component_spec 查看详细规范' : '尝试其他关键词',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: '搜索失败: ' + (error instanceof Error ? error.message : String(error)),
+            };
+        }
+    },
+};
+// 解析 frontmatter
+function parseFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match)
+        return {};
+    const frontmatter = {};
+    const lines = match[1].split('\n');
+    for (const line of lines) {
+        const colonIndex = line.indexOf(':');
+        if (colonIndex > 0) {
+            const key = line.slice(0, colonIndex).trim();
+            const value = line.slice(colonIndex + 1).trim().replace(/^["']|["']$/g, '');
+            frontmatter[key] = value;
+        }
+    }
+    return frontmatter;
+}
+// 提取包含关键词的片段
+function extractSnippet(content, keyword) {
+    const lowerContent = content.toLowerCase();
+    const lowerKeyword = keyword.toLowerCase();
+    const index = lowerContent.indexOf(lowerKeyword);
+    if (index === -1)
+        return '';
+    const start = Math.max(0, index - 50);
+    const end = Math.min(content.length, index + keyword.length + 50);
+    return content.slice(start, end).replace(/\n/g, ' ');
+}
+//# sourceMappingURL=search-components.js.map

package/dist/tools/search-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-components.js","sourceRoot":"","sources":["../../src/tools/search-components.ts"],"names":[],"mappings":"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"}

package/dist/tools/validate-html.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Tool: validate_html
+ *
+ * 验证 HTML 代码是否符合 PDA Kit 规范
+ */
+export declare const validateHtmlTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            htmlContent: {
+                type: string;
+                description: string;
+            };
+            strictMode: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+    handler: (args: {
+        htmlContent: string;
+        strictMode?: boolean;
+    }) => Promise<{
+        success: boolean;
+        score: number;
+        errors: any[];
+        warnings: any[];
+        note: string;
+    } | {
+        success: any;
+        score: any;
+        errors: any;
+        warnings: any;
+        report: any;
+        canDeliver: boolean;
+        hint: string;
+    }>;
+};
+//# sourceMappingURL=validate-html.d.ts.map

package/dist/tools/validate-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-html.d.ts","sourceRoot":"","sources":["../../src/tools/validate-html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;oBAkBL;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE;;;;;;;;;;;;;;;CAgCpE,CAAC"}

package/dist/tools/validate-html.js

@@ -0,0 +1,116 @@
+/**
+ * Tool: validate_html
+ *
+ * 验证 HTML 代码是否符合 PDA Kit 规范
+ */
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+export const validateHtmlTool = {
+    name: 'validate_html',
+    description: '验证 HTML 代码是否符合 PDA Kit 设计规范，检查颜色、圆角、动效等',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            htmlContent: {
+                type: 'string',
+                description: '要验证的 HTML 代码',
+            },
+            strictMode: {
+                type: 'boolean',
+                description: '严格模式（P1 错误也视为失败）',
+                default: false,
+            },
+        },
+        required: ['htmlContent'],
+    },
+    handler: async (args) => {
+        const { htmlContent, strictMode = false } = args;
+        // 获取 PDA Kit 根目录
+        const pdaKitRoot = process.env.PDA_KIT_ROOT || join(__dirname, '../../..');
+        try {
+            // 动态导入验证器
+            const { HTMLValidator } = await import(join(pdaKitRoot, 'pda-kit-system/scripts/validate.ts'));
+            const validator = new HTMLValidator({ strictMode });
+            const result = validator.validate(htmlContent);
+            const report = validator.generateReport(result);
+            return {
+                success: result.success && result.errors.length === 0,
+                score: result.score,
+                errors: result.errors,
+                warnings: result.warnings,
+                report,
+                canDeliver: result.errors.filter((e) => e.level === 'P0').length === 0,
+                hint: result.success
+                    ? '代码符合 PDA Kit 规范'
+                    : '请修复上述错误后重新验证',
+            };
+        }
+        catch (error) {
+            // 如果动态导入失败，使用内置的简单验证
+            return simpleValidate(htmlContent);
+        }
+    },
+};
+// 简单验证（备用）
+function simpleValidate(htmlContent) {
+    const errors = [];
+    const warnings = [];
+    // 检查裸 Hex 颜色
+    const hexMatches = htmlContent.match(/#[0-9a-fA-F]{3,6}\b/g);
+    if (hexMatches) {
+        hexMatches.forEach((hex) => {
+            if (!htmlContent.includes(`var(--color-${hex})`)) {
+                errors.push({
+                    type: 'color',
+                    level: 'P0',
+                    message: `发现裸 Hex 颜色: ${hex}`,
+                    suggestion: '使用 var(--color-*) Token',
+                });
+            }
+        });
+    }
+    // 检查 transition
+    if (htmlContent.match(/transition\s*:/i)) {
+        errors.push({
+            type: 'animation',
+            level: 'P0',
+            message: '发现 transition 动效',
+            suggestion: '工业端严禁动效',
+        });
+    }
+    // 检查圆角
+    const radiusMatches = htmlContent.match(/border-radius\s*:\s*(\d+)px/g);
+    if (radiusMatches) {
+        radiusMatches.forEach((match) => {
+            const radius = parseInt(match.match(/\d+/)?.[0] || '0');
+            if (radius > 4 && radius !== 16 && radius !== 20) {
+                errors.push({
+                    type: 'borderRadius',
+                    level: 'P1',
+                    message: `圆角 ${radius}px 超过限制`,
+                    suggestion: '使用 4px/16px/20px',
+                });
+            }
+        });
+    }
+    // 检查 Emoji
+    const emojiMatches = htmlContent.match(/[\u{1F600}-\u{1F64F}]|[\u{1F300}-\u{1F5FF}]|[\u{1F680}-\u{1F6FF}]/gu);
+    if (emojiMatches) {
+        errors.push({
+            type: 'emoji',
+            level: 'P0',
+            message: `发现 Emoji: ${emojiMatches[0]}`,
+            suggestion: '禁止使用 Emoji',
+        });
+    }
+    const score = Math.max(0, 100 - errors.length * 10 - warnings.length * 5);
+    return {
+        success: errors.length === 0,
+        score,
+        errors,
+        warnings,
+        note: '这是简化版验证，完整验证请确保 pda-kit-system 已安装',
+    };
+}
+//# sourceMappingURL=validate-html.js.map

package/dist/tools/validate-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-html.js","sourceRoot":"","sources":["../../src/tools/validate-html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,yCAAyC;IACtD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,kBAAkB;gBAC/B,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;IACD,OAAO,EAAE,KAAK,EAAE,IAAmD,EAAE,EAAE;QACrE,MAAM,EAAE,WAAW,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAEjD,iBAAiB;QACjB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAE3E,IAAI,CAAC;YACH,UAAU;YACV,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CACpC,IAAI,CAAC,UAAU,EAAE,oCAAoC,CAAC,CACvD,CAAC;YAEF,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAEhD,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;gBACrD,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM;gBACN,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;gBAC3E,IAAI,EAAE,MAAM,CAAC,OAAO;oBAClB,CAAC,CAAC,iBAAiB;oBACnB,CAAC,CAAC,cAAc;aACnB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,qBAAqB;YACrB,OAAO,cAAc,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF,CAAC;AAEF,WAAW;AACX,SAAS,cAAc,CAAC,WAAmB;IACzC,MAAM,MAAM,GAAU,EAAE,CAAC;IACzB,MAAM,QAAQ,GAAU,EAAE,CAAC;IAE3B,aAAa;IACb,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC7D,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACzB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,eAAe,GAAG,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,eAAe,GAAG,EAAE;oBAC7B,UAAU,EAAE,yBAAyB;iBACtC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAChB,IAAI,WAAW,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,kBAAkB;YAC3B,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;IACP,MAAM,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACxE,IAAI,aAAa,EAAE,CAAC;QAClB,aAAa,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;YACxD,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,cAAc;oBACpB,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,MAAM,MAAM,SAAS;oBAC9B,UAAU,EAAE,kBAAkB;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,WAAW;IACX,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CACpC,qEAAqE,CACtE,CAAC;IACF,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,aAAa,YAAY,CAAC,CAAC,CAAC,EAAE;YACvC,UAAU,EAAE,YAAY;SACzB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAE1E,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC5B,KAAK;QACL,MAAM;QACN,QAAQ;QACR,IAAI,EAAE,oCAAoC;KAC3C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "pda-kit-mcp-server",
+  "version": "2.0.1",
+  "description": "PDA Kit MCP Server - 让 AI 轻松使用 PDA Kit 设计系统",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "pda-kit-mcp": "./bin/pda-kit-mcp.js"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "spec-data/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && npm run copy-spec",
+    "copy-spec": "node scripts/copy-spec.js",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "jest",
+    "prepublishOnly": "npm run build",
+    "publish:npm": "npm publish --access public"
+  },
+  "keywords": [
+    "mcp",
+    "pda-kit",
+    "design-system",
+    "ai",
+    "model-context-protocol"
+  ],
+  "author": "PDA Kit Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Yuuuyi/pda-ai-project.git",
+    "directory": "mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/Yuuuyi/pda-ai-project/issues"
+  },
+  "homepage": "https://github.com/Yuuuyi/pda-ai-project#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "commander": "^11.1.0",
+    "gray-matter": "^4.0.3",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^20.19.43",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}