pda-kit-mcp-server 2.0.1

package/README.md

@@ -0,0 +1,107 @@
+# pda-kit-mcp-server
+
+PDA Kit MCP Server - 让 AI 轻松使用 PDA Kit 设计系统
+
+## 🚀 零配置快速开始
+
+### 方式一：npx 直接运行（推荐，无需安装）
+
+**Claude Desktop 配置：**
+```json
+{
+  "mcpServers": {
+    "pda-kit": {
+      "command": "npx",
+      "args": ["-y", "pda-kit-mcp-server"]
+    }
+  }
+}
+```
+
+**Cursor 配置：**
+```json
+{
+  "mcpServers": {
+    "pda-kit": {
+      "command": "npx",
+      "args": ["-y", "pda-kit-mcp-server"]
+    }
+  }
+}
+```
+
+**Trae 配置：**
+```json
+{
+  "mcpServers": {
+    "pda-kit": {
+      "command": "npx",
+      "args": ["-y", "pda-kit-mcp-server"]
+    }
+  }
+}
+```
+
+> 💡 **只需复制上面的配置到 AI 客户端，即可直接使用！**
+
+---
+
+### 方式二：全局安装
+
+```bash
+npm install -g pda-kit-mcp-server
+```
+
+**配置（使用全局命令）：**
+```json
+{
+  "mcpServers": {
+    "pda-kit": {
+      "command": "pda-kit-mcp-server"
+    }
+  }
+}
+```
+
+---
+
+## 💬 使用示例
+
+配置完成后，在 AI 对话中直接使用：
+
+```
+用户：帮我生成一个扫描输入框
+
+AI：[调用 pda-kit/get_component_spec]
+    [调用 pda-kit/generate_component]
+
+这是符合 PDA Kit 规范的 ScanInput 组件代码：
+...
+```
+
+---
+
+## 📦 可用 Tools
+
+| Tool | 功能 |
+|------|------|
+| `get_component_spec` | 获取组件规范文档 |
+| `list_components` | 列出所有可用组件 |
+| `search_components` | 搜索组件 |
+| `validate_html` | 验证 HTML 代码规范 |
+| `generate_component` | 生成组件代码 |
+| `get_global_rules` | 获取全局约束规则 |
+
+---
+
+## 📚 文档
+
+- [完整文档](https://github.com/Yuuuyi/pda-ai-project#readme)
+- [组件规范](https://github.com/Yuuuyi/pda-ai-project/tree/main/PDAKit-规范/components)
+- [更新日志](https://github.com/Yuuuyi/pda-ai-project/blob/main/CHANGELOG.md)
+
+---
+
+## 📄 许可证
+
+MIT

package/bin/pda-kit-mcp.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+/**
+ * PDA Kit MCP Server - 零配置启动脚本
+ * 
+ * 自动检测环境并启动 MCP 服务
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// 服务器脚本路径
+const serverPath = join(__dirname, '..', 'dist', 'stdio-server.js');
+
+// 启动服务器
+const child = spawn('node', [serverPath], {
+  stdio: ['inherit', 'inherit', 'inherit'],
+  env: {
+    ...process.env,
+    PDA_KIT_SPEC_PATH: join(__dirname, '..', 'spec-data')
+  }
+});
+
+child.on('error', (err) => {
+  console.error('启动失败:', err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code) => {
+  process.exit(code);
+});

package/dist/file-reader.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 动态读取文件内容（每次调用都重新从磁盘读取）
+ */
+export declare function readTextFile(filePath: string): Promise<string>;
+/**
+ * 动态读取 JSON 文件
+ */
+export declare function readJsonFile<T = any>(filePath: string): Promise<T>;
+/**
+ * 列出目录下所有文件（实时读取，不缓存）
+ * @param dirPath 目录路径
+ * @param filter 文件过滤函数
+ */
+export declare function listFiles(dirPath: string, filter?: (name: string) => boolean): Promise<string[]>;
+export interface FrontmatterMeta {
+    id: string;
+    name: string;
+    category?: string;
+    level?: "atom" | "molecule" | "template";
+    source?: string;
+    source_url?: string;
+    source_doc_id?: string;
+    component_count?: number;
+    tags?: string[];
+    since?: string;
+    inherits?: string;
+    [key: string]: any;
+}
+export interface ParsedMarkdown {
+    meta: FrontmatterMeta;
+    content: string;
+    raw: string;
+}
+/**
+ * 解析 Markdown 文件的 Frontmatter + 正文
+ */
+export declare function parseMarkdown(filePath: string): Promise<ParsedMarkdown>;
+export interface ComponentMeta {
+    /** 文件名（不含扩展名） */
+    file: string;
+    /** 组件 ID */
+    id: string;
+    /** 组件中文名 */
+    name: string;
+    /** 层级 */
+    level?: "atom" | "molecule" | "template";
+    /** 变体数量 */
+    component_count?: number;
+    /** 来源 */
+    source?: string;
+    /** 标签 */
+    tags?: string[];
+    /** 相对路径 */
+    path: string;
+}
+/**
+ * 实时扫描 components/ 目录，返回所有组件的元数据列表
+ */
+export declare function listComponents(): Promise<ComponentMeta[]>;
+/**
+ * 实时扫描 templates/ 目录，返回所有模板元数据
+ */
+export declare function listTemplates(): Promise<{
+    file: string;
+    path: string;
+}[]>;
+export interface IconEntry {
+    /** 语义名称 */
+    name: string;
+    /** 文件名 */
+    file: string;
+    /** 相对路径（相对于 PDAKit-规范） */
+    path: string;
+    /** 标签 */
+    tags?: string[];
+    /** 所属分类 */
+    category: string;
+}
+/**
+ * 实时扫描所有图标（通用 + 应用 + 标签栏）
+ */
+export declare function listAllIcons(): Promise<IconEntry[]>;
+//# sourceMappingURL=file-reader.d.ts.map

package/dist/file-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../src/file-reader.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAOxE;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBnB;AAMD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAQ7E;AAMD,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IACzC,WAAW;IACX,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS;IACT,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAiC/D;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAO/E;AAMD,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS;IACT,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0CD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAUzD"}

package/dist/file-reader.js

@@ -0,0 +1,170 @@
+/**
+ * PDA Kit MCP Server — 动态文件读取器
+ *
+ * ⚠️ 核心设计原则：
+ * 1. 【严禁缓存】每次 AI 调用都重新 read 文件系统，绝不使用内存变量缓存
+ * 2. 【实时同步】修改 Markdown 规范后，AI 客户端下次对话秒级自动同步
+ * 3. 【容错处理】文件不存在时返回明确错误信息，不静默失败
+ */
+import { readFile, readdir } from "node:fs/promises";
+import { basename, join } from "node:path";
+import matter from "gray-matter";
+// ═══════════════════════════════════════════
+// 基础读取操作
+// ═══════════════════════════════════════════
+/**
+ * 动态读取文件内容（每次调用都重新从磁盘读取）
+ */
+export async function readTextFile(filePath) {
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw new Error(`文件不存在: ${filePath}`);
+        }
+        throw new Error(`读取文件失败: ${filePath} — ${error.message}`);
+    }
+}
+/**
+ * 动态读取 JSON 文件
+ */
+export async function readJsonFile(filePath) {
+    const text = await readTextFile(filePath);
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`JSON 解析失败: ${filePath} — ${error.message}`);
+    }
+}
+/**
+ * 列出目录下所有文件（实时读取，不缓存）
+ * @param dirPath 目录路径
+ * @param filter 文件过滤函数
+ */
+export async function listFiles(dirPath, filter) {
+    try {
+        const entries = await readdir(dirPath);
+        let files = entries.filter((name) => {
+            // 排除隐藏文件
+            if (name.startsWith("."))
+                return false;
+            if (filter)
+                return filter(name);
+            return true;
+        });
+        return files.sort();
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw new Error(`目录不存在: ${dirPath}`);
+        }
+        throw new Error(`列出目录失败: ${dirPath} — ${error.message}`);
+    }
+}
+/**
+ * 解析 Markdown 文件的 Frontmatter + 正文
+ */
+export async function parseMarkdown(filePath) {
+    const raw = await readTextFile(filePath);
+    const { data, content } = matter(raw);
+    return {
+        meta: data,
+        content: content.trim(),
+        raw,
+    };
+}
+/**
+ * 实时扫描 components/ 目录，返回所有组件的元数据列表
+ */
+export async function listComponents() {
+    const dir = join((await import("./paths.js")).PATHS.components);
+    const files = await listFiles(dir, (name) => name.endsWith(".md"));
+    const components = [];
+    for (const file of files) {
+        const filePath = join(dir, file);
+        try {
+            const { meta } = await parseMarkdown(filePath);
+            components.push({
+                file,
+                id: meta.id || basename(file, ".md"),
+                name: meta.name || basename(file, ".md"),
+                level: meta.level,
+                component_count: meta.component_count,
+                source: meta.source,
+                tags: meta.tags,
+                path: `components/${file}`,
+            });
+        }
+        catch {
+            // 跳过无法解析的文件
+            components.push({
+                file,
+                id: basename(file, ".md"),
+                name: basename(file, ".md"),
+                path: `components/${file}`,
+            });
+        }
+    }
+    return components;
+}
+/**
+ * 实时扫描 templates/ 目录，返回所有模板元数据
+ */
+export async function listTemplates() {
+    const { PATHS } = await import("./paths.js");
+    const files = await listFiles(PATHS.templates);
+    return files.map((file) => ({
+        file,
+        path: `templates/${file}`,
+    }));
+}
+/**
+ * 递归扫描图标目录，收集所有 SVG 文件
+ */
+async function scanSvgDir(baseDir, category, relativePrefix) {
+    const icons = [];
+    async function walk(dir, relPath) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name.startsWith("."))
+                    continue;
+                const fullPath = join(dir, entry.name);
+                const rel = relPath ? `${relPath}/${entry.name}` : entry.name;
+                if (entry.isDirectory()) {
+                    await walk(fullPath, rel);
+                }
+                else if (entry.name.endsWith(".svg")) {
+                    // 中文文件名转换为 snake_case 显示名
+                    const baseName = basename(entry.name, ".svg");
+                    icons.push({
+                        name: baseName,
+                        file: entry.name,
+                        path: `${relativePrefix}/${rel}`,
+                        category,
+                    });
+                }
+            }
+        }
+        catch {
+            // 目录不存在时跳过
+        }
+    }
+    await walk(baseDir, "");
+    return icons;
+}
+/**
+ * 实时扫描所有图标（通用 + 应用 + 标签栏）
+ */
+export async function listAllIcons() {
+    const { PATHS } = await import("./paths.js");
+    const [common, app, tabBar] = await Promise.all([
+        scanSvgDir(join(PATHS.icons, "assets"), "通用图标", "icons/assets"),
+        scanSvgDir(join(PATHS.iconsApp, "应用"), "应用入口图标", "icons-应用/应用"),
+        scanSvgDir(PATHS.iconsTabBar, "标签栏图标", "icons-标签栏"),
+    ]);
+    return [...common, ...app, ...tabBar];
+}
+//# sourceMappingURL=file-reader.js.map

package/dist/file-reader.js.map

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

package/dist/http-entry.d.ts

@@ -0,0 +1,12 @@
+/**
+ * PDA Kit MCP Server — HTTP/SSE 入口
+ *
+ * 部署到内网服务器后，团队成员统一使用同一个 URL:
+ *   http://<server>:3000/sse
+ *
+ * 启动方式:
+ *   node dist/http-entry.js
+ *   或 npm run start:http
+ */
+export {};
+//# sourceMappingURL=http-entry.d.ts.map

package/dist/http-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-entry.d.ts","sourceRoot":"","sources":["../src/http-entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/http-entry.js

@@ -0,0 +1,149 @@
+/**
+ * PDA Kit MCP Server — HTTP/SSE 入口
+ *
+ * 部署到内网服务器后，团队成员统一使用同一个 URL:
+ *   http://<server>:3000/sse
+ *
+ * 启动方式:
+ *   node dist/http-entry.js
+ *   或 npm run start:http
+ */
+import express from "express";
+import cors from "cors";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { fileURLToPath } from 'url';
+import { join, dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// 导入 tools
+import { getComponentSpecTool } from './tools/get-component-spec.js';
+import { listComponentsTool } from './tools/list-components.js';
+import { searchComponentsTool } from './tools/search-components.js';
+import { validateHtmlTool } from './tools/validate-html.js';
+import { generateComponentTool } from './tools/generate-component.js';
+import { getGlobalRulesTool } from './tools/get-global-rules.js';
+const PORT = parseInt(process.env.PORT || "3000", 10);
+const app = express();
+app.use(cors());
+app.use(express.json());
+// 路径配置
+const PATHS = {
+    root: process.env.PDA_KIT_ROOT || join(__dirname, '../..'),
+};
+// 自动 Git Pull 配置
+const AUTO_PULL_INTERVAL_MS = 60 * 60 * 1000; // 1小时
+function autoGitPull() {
+    // 简化版，实际使用时可以添加 git pull 逻辑
+    console.error('[PDA Kit] Git 自动同步检查');
+}
+// 注册所有 Tools
+const tools = [
+    getComponentSpecTool,
+    listComponentsTool,
+    searchComponentsTool,
+    validateHtmlTool,
+    generateComponentTool,
+    getGlobalRulesTool,
+];
+// 创建 MCP Server
+const server = new Server({
+    name: 'pda-kit-mcp-server',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// 处理工具列表请求
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+        })),
+    };
+});
+// 处理工具调用请求
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const tool = tools.find((t) => t.name === name);
+    if (!tool) {
+        throw new Error(`未知工具: ${name}`);
+    }
+    try {
+        const result = await tool.handler(args || {});
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ success: false, error: errorMessage }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// 存储活跃的 transport 会话（按 sessionId）
+const transports = new Map();
+// SSE 端点 — AI 客户端通过 GET 建立长连接
+app.get("/sse", async (_req, res) => {
+    console.error("[PDA Kit HTTP] 新 SSE 连接");
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+    res.flushHeaders();
+    const transport = new SSEServerTransport("/messages", res);
+    transports.set(transport.sessionId, transport);
+    res.on("close", () => {
+        transports.delete(transport.sessionId);
+        console.error("[PDA Kit HTTP] SSE 连接关闭:", transport.sessionId);
+    });
+    await server.connect(transport);
+});
+// 消息端点 — AI 客户端通过 POST 发送请求
+app.post("/messages", async (req, res) => {
+    const sessionId = req.query.sessionId;
+    if (!sessionId) {
+        res.status(400).json({ error: "缺少 sessionId 参数" });
+        return;
+    }
+    const transport = transports.get(sessionId);
+    if (!transport) {
+        res.status(404).json({ error: "未找到对应的 SSE 会话" });
+        return;
+    }
+    await transport.handlePostMessage(req, res);
+});
+// 健康检查
+app.get("/health", (_req, res) => {
+    res.json({
+        status: "ok",
+        mode: "http/sse",
+        specRoot: PATHS.root,
+        activeSessions: transports.size,
+    });
+});
+app.listen(PORT, () => {
+    console.error(`[PDA Kit HTTP] 服务器已启动: http://localhost:${PORT}`);
+    console.error(`[PDA Kit HTTP] SSE 端点: http://localhost:${PORT}/sse`);
+    console.error(`[PDA Kit HTTP] 规范路径: ${PATHS.root}`);
+    console.error("[PDA Kit HTTP] 所有数据实时读取文件系统，无内存缓存。");
+    autoGitPull();
+    setInterval(autoGitPull, AUTO_PULL_INTERVAL_MS);
+    console.error(`[PDA Kit HTTP] Git 自动同步已启用（每 ${AUTO_PULL_INTERVAL_MS / 3600000} 小时一次）`);
+});
+//# sourceMappingURL=http-entry.js.map

package/dist/http-entry.js.map

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

package/dist/http-server.d.ts

@@ -0,0 +1,5 @@
+/**
+ * PDA Kit MCP Server - HTTP/SSE 入口
+ */
+export declare function startHttpServer(port?: number): Promise<void>;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../src/http-server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAiFH,wBAAsB,eAAe,CAAC,IAAI,GAAE,MAAa,iBAsDxD"}