pda-kit-mcp-server 2.0.1

package/dist/http-server.js

@@ -0,0 +1,114 @@
+/**
+ * PDA Kit MCP Server - HTTP/SSE 入口
+ */
+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 { 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 tools = [
+    getComponentSpecTool,
+    listComponentsTool,
+    searchComponentsTool,
+    validateHtmlTool,
+    generateComponentTool,
+    getGlobalRulesTool,
+];
+const server = new Server({
+    name: 'pda-kit-mcp-server',
+    version: '2.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,
+        };
+    }
+});
+export async function startHttpServer(port = 3000) {
+    const app = express();
+    app.use(cors());
+    app.use(express.json());
+    const transports = new Map();
+    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);
+    });
+    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",
+            activeSessions: transports.size,
+        });
+    });
+    app.listen(port, () => {
+        console.error(`[PDA Kit HTTP] 服务器已启动: http://localhost:${port}`);
+        console.error(`[PDA Kit HTTP] SSE 端点: http://localhost:${port}/sse`);
+    });
+}
+//# sourceMappingURL=http-server.js.map

package/dist/http-server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * PDA Kit MCP Server
+ *
+ * 让 AI 助手轻松使用 PDA Kit 设计系统规范
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * PDA Kit MCP Server
+ *
+ * 让 AI 助手轻松使用 PDA Kit 设计系统规范
+ */
+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 { 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';
+// 注册所有 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;
+    // 查找对应的 tool
+    const tool = tools.find((t) => t.name === name);
+    if (!tool) {
+        throw new Error(`未知工具: ${name}`);
+    }
+    try {
+        // 执行 tool handler
+        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,
+        };
+    }
+});
+// 启动服务器
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('PDA Kit MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,37 @@
+/** 规范目录下的子目录路径 */
+export declare const PATHS: {
+    /** PDAKit-规范/ 根 */
+    readonly root: string;
+    /** tokens/ — 设计令牌 */
+    readonly tokens: string;
+    /** components/ — 组件规范 */
+    readonly components: string;
+    /** patterns/ — 布局模式 */
+    readonly patterns: string;
+    /** templates/ — 页面模板 */
+    readonly templates: string;
+    /** icons/ — 通用图标 */
+    readonly icons: string;
+    /** icons-应用/ — 应用入口图标 */
+    readonly iconsApp: string;
+    /** icons-标签栏/ — 标签栏图标 */
+    readonly iconsTabBar: string;
+    /** demos/ — 演示文件 */
+    readonly demos: string;
+    /** README.md */
+    readonly readme: string;
+};
+/** 单个文件路径快捷引用 */
+export declare const FILES: {
+    readonly colors: string;
+    readonly spacing: string;
+    readonly typography: string;
+    readonly variablesCss: string;
+    readonly tailwindConfig: string;
+    readonly layout: string;
+    readonly assemblyRules: string;
+    readonly baseHtml: string;
+    readonly iconRegistry: string;
+    readonly iconsDoc: string;
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAmBA,kBAAkB;AAClB,eAAO,MAAM,KAAK;IAChB,mBAAmB;;IAEnB,qBAAqB;;IAErB,yBAAyB;;IAEzB,uBAAuB;;IAEvB,wBAAwB;;IAExB,oBAAoB;;IAEpB,yBAAyB;;IAEzB,yBAAyB;;IAEzB,oBAAoB;;IAEpB,gBAAgB;;CAER,CAAC;AAEX,iBAAiB;AACjB,eAAO,MAAM,KAAK;;;;;;;;;;;CAWR,CAAC"}

package/dist/paths.js

@@ -0,0 +1,52 @@
+/**
+ * PDA Kit MCP Server — 路径解析模块
+ *
+ * 所有路径均为【动态计算】，绝不硬编码绝对路径。
+ * 通过相对路径从 mcp-server/ 定位到上级 PDAKit-规范/ 目录。
+ */
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+// 当前文件所在目录: mcp-server/src/
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// mcp-server/ 根目录
+const SERVER_ROOT = resolve(__dirname, "..");
+// PDAKit-规范/ 目录（与 mcp-server 平级）
+const SPEC_ROOT = resolve(SERVER_ROOT, "..", "PDAKit-规范");
+/** 规范目录下的子目录路径 */
+export const PATHS = {
+    /** PDAKit-规范/ 根 */
+    root: SPEC_ROOT,
+    /** tokens/ — 设计令牌 */
+    tokens: resolve(SPEC_ROOT, "tokens"),
+    /** components/ — 组件规范 */
+    components: resolve(SPEC_ROOT, "components"),
+    /** patterns/ — 布局模式 */
+    patterns: resolve(SPEC_ROOT, "patterns"),
+    /** templates/ — 页面模板 */
+    templates: resolve(SPEC_ROOT, "templates"),
+    /** icons/ — 通用图标 */
+    icons: resolve(SPEC_ROOT, "icons"),
+    /** icons-应用/ — 应用入口图标 */
+    iconsApp: resolve(SPEC_ROOT, "icons-应用"),
+    /** icons-标签栏/ — 标签栏图标 */
+    iconsTabBar: resolve(SPEC_ROOT, "icons-标签栏"),
+    /** demos/ — 演示文件 */
+    demos: resolve(SPEC_ROOT, "demos"),
+    /** README.md */
+    readme: resolve(SPEC_ROOT, "README.md"),
+};
+/** 单个文件路径快捷引用 */
+export const FILES = {
+    colors: resolve(PATHS.tokens, "colors.md"),
+    spacing: resolve(PATHS.tokens, "spacing.md"),
+    typography: resolve(PATHS.tokens, "typography.md"),
+    variablesCss: resolve(PATHS.tokens, "variables.css"),
+    tailwindConfig: resolve(PATHS.root, "tailwind.config.js"),
+    layout: resolve(PATHS.patterns, "layout.md"),
+    assemblyRules: resolve(PATHS.templates, "ASSEMBLY_RULES.md"),
+    baseHtml: resolve(PATHS.templates, "_base.html"),
+    iconRegistry: resolve(PATHS.icons, "icon-registry.json"),
+    iconsDoc: resolve(PATHS.icons, "icons.md"),
+};
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,4BAA4B;AAC5B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,kBAAkB;AAClB,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAE7C,iCAAiC;AACjC,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AAE1D,kBAAkB;AAClB,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,mBAAmB;IACnB,IAAI,EAAE,SAAS;IACf,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC;IACpC,yBAAyB;IACzB,UAAU,EAAE,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC;IAC5C,uBAAuB;IACvB,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC;IACxC,wBAAwB;IACxB,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;IAC1C,oBAAoB;IACpB,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;IAClC,yBAAyB;IACzB,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC;IACxC,yBAAyB;IACzB,WAAW,EAAE,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;IAC5C,oBAAoB;IACpB,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;IAClC,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC;CAC/B,CAAC;AAEX,iBAAiB;AACjB,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,YAAY,CAAC;IAC5C,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC;IAClD,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe,CAAC;IACpD,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACzD,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC5C,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,mBAAmB,CAAC;IAC5D,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC;IAChD,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACxD,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC;CAClC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * PDAKit MCP Server - TypeScript Implementation
+ *
+ * 核心特性：
+ * 1. 动态文件读取 - 每次调用工具都实时 fs.readFile，无内存缓存
+ * 2. 最高宪法注入 - 自动拼接 ANTI_PATTERNS.md + DECISION_TREE.md 到上下文
+ * 3. 完整 Tools 接口 - get_global_tokens / list_all_available_components /
+ *                      fetch_component_spec / get_page_template
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/server.js

@@ -0,0 +1,308 @@
+#!/usr/bin/env node
+/**
+ * PDAKit MCP Server - TypeScript Implementation
+ *
+ * 核心特性：
+ * 1. 动态文件读取 - 每次调用工具都实时 fs.readFile，无内存缓存
+ * 2. 最高宪法注入 - 自动拼接 ANTI_PATTERNS.md + DECISION_TREE.md 到上下文
+ * 3. 完整 Tools 接口 - get_global_tokens / list_all_available_components /
+ *                      fetch_component_spec / get_page_template
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import * as fs from "fs/promises";
+import * as path from "path";
+import { fileURLToPath } from "url";
+// 获取当前文件目录（ESM 兼容）
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// 项目根目录（mcp-server 的父目录）
+const PROJECT_ROOT = path.resolve(__dirname, "../..");
+const SPEC_DIR = path.join(PROJECT_ROOT, "PDAKit-规范");
+// 最高宪法文件路径
+const CONSTITUTION_FILES = {
+    antiPatterns: path.join(SPEC_DIR, "ANTI_PATTERNS.md"),
+    decisionTree: path.join(SPEC_DIR, "DECISION_TREE.md"),
+};
+/**
+ * 动态读取文件 - 严禁缓存，每次必须磁盘 IO
+ */
+async function readFileDynamic(filePath) {
+    try {
+        return await fs.readFile(filePath, "utf-8");
+    }
+    catch (error) {
+        const err = error;
+        if (err.code === "ENOENT") {
+            throw new Error(`文件不存在: ${path.relative(PROJECT_ROOT, filePath)}`);
+        }
+        throw new Error(`读取失败: ${err.message}`);
+    }
+}
+/**
+ * 读取最高宪法（ANTI_PATTERNS + DECISION_TREE）
+ * 在 initialization 和每次 tool 调用时注入
+ */
+async function loadConstitution() {
+    const [antiPatterns, decisionTree] = await Promise.all([
+        readFileDynamic(CONSTITUTION_FILES.antiPatterns).catch(() => "# 反例对照表\n> 文件加载中..."),
+        readFileDynamic(CONSTITUTION_FILES.decisionTree).catch(() => "# 决策树\n> 文件加载中..."),
+    ]);
+    return `
+╔══════════════════════════════════════════════════════════════════╗
+║                    PDAKit 最高宪法（强制遵循）                      ║
+╠══════════════════════════════════════════════════════════════════╣
+
+${antiPatterns}
+
+${decisionTree}
+
+╚══════════════════════════════════════════════════════════════════╝
+`;
+}
+/**
+ * 列出目录下的所有 .md 文件（不含扩展名）
+ */
+async function listMdFiles(dirPath) {
+    try {
+        const fullPath = path.join(SPEC_DIR, dirPath);
+        const entries = await fs.readdir(fullPath, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+            .map((entry) => entry.name.replace(".md", ""));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 定义所有可用 Tools
+ */
+const TOOLS = [
+    {
+        name: "get_global_tokens",
+        description: "动态读取并返回 tokens/ 目录下的样式底座（colors, spacing, typography, variables）",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "list_all_available_components",
+        description: "列出 components/ 目录下所有可用的 .md 组件文件名",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: "fetch_component_spec",
+        description: "动态读取对应组件的 .md 完整规范文本",
+        inputSchema: {
+            type: "object",
+            properties: {
+                component_name: {
+                    type: "string",
+                    description: "组件名称，如 'button', 'dialog', 'scan-input'",
+                },
+            },
+            required: ["component_name"],
+        },
+    },
+    {
+        name: "get_page_template",
+        description: "读取 templates/ 下的流式布局网格和页面骨架",
+        inputSchema: {
+            type: "object",
+            properties: {
+                template_name: {
+                    type: "string",
+                    description: "模板名称，如 'ASSEMBLY_RULES', '_base', 'AI_SPEC_TEMPLATE'",
+                },
+            },
+            required: ["template_name"],
+        },
+    },
+    {
+        name: "get_constitution",
+        description: "获取最高宪法（ANTI_PATTERNS.md + DECISION_TREE.md）",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+];
+/**
+ * 创建 MCP Server 实例
+ */
+const server = new Server({
+    name: "pdakit-mcp-server",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        resources: {},
+        tools: {},
+    },
+});
+/**
+ * 处理 Tools 列表请求
+ */
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+/**
+ * 处理 Tool 调用请求 - 动态读取，注入宪法
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    // 每次调用都重新加载宪法（动态注入）
+    const constitution = await loadConstitution();
+    try {
+        switch (name) {
+            case "get_global_tokens": {
+                const tokens = await Promise.all([
+                    readFileDynamic(path.join(SPEC_DIR, "tokens/colors.md")),
+                    readFileDynamic(path.join(SPEC_DIR, "tokens/spacing.md")),
+                    readFileDynamic(path.join(SPEC_DIR, "tokens/typography.md")),
+                    readFileDynamic(path.join(SPEC_DIR, "tokens/variables.css")),
+                ]);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `${constitution}\n\n## Global Tokens\n\n### Colors\n${tokens[0]}\n\n### Spacing\n${tokens[1]}\n\n### Typography\n${tokens[2]}\n\n### CSS Variables\n${tokens[3]}`,
+                        },
+                    ],
+                };
+            }
+            case "list_all_available_components": {
+                const components = await listMdFiles("components");
+                const businessScenarios = await listMdFiles("business/scenarios");
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `${constitution}\n\n## 可用组件列表\n\n### 原子组件 (components/)\n${components.map((c) => `- ${c}`).join("\n")}\n\n### 业务场景 (business/scenarios/)\n${businessScenarios.map((s) => `- ${s}`).join("\n")}\n\n共计: ${components.length} 个原子组件, ${businessScenarios.length} 个业务场景`,
+                        },
+                    ],
+                };
+            }
+            case "fetch_component_spec": {
+                const componentName = args.component_name;
+                // 先尝试从 components 目录读取
+                let filePath = path.join(SPEC_DIR, "components", `${componentName}.md`);
+                let content;
+                try {
+                    content = await readFileDynamic(filePath);
+                }
+                catch {
+                    // 如果失败，尝试从 business/scenarios 读取
+                    filePath = path.join(SPEC_DIR, "business/scenarios", `${componentName}.md`);
+                    content = await readFileDynamic(filePath);
+                }
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `${constitution}\n\n## 组件规范: ${componentName}\n\n${content}`,
+                        },
+                    ],
+                };
+            }
+            case "get_page_template": {
+                const templateName = args.template_name;
+                const filePath = path.join(SPEC_DIR, "templates", `${templateName}.md`);
+                const content = await readFileDynamic(filePath);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `${constitution}\n\n## 页面模板: ${templateName}\n\n${content}`,
+                        },
+                    ],
+                };
+            }
+            case "get_constitution": {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: constitution,
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`未知工具: ${name}`);
+        }
+    }
+    catch (error) {
+        const err = error;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `错误: ${err.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+/**
+ * 处理资源列表请求
+ */
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    const components = await listMdFiles("components");
+    return {
+        resources: components.map((name) => ({
+            uri: `pdakit://components/${name}`,
+            mimeType: "text/markdown",
+            name: `${name} 组件规范`,
+            description: `PDAKit ${name} 组件的完整规范文档`,
+        })),
+    };
+});
+/**
+ * 处理资源读取请求
+ */
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const uri = request.params.uri;
+    const match = uri.match(/^pdakit:\/\/components\/(.+)$/);
+    if (!match) {
+        throw new Error(`无效的资源 URI: ${uri}`);
+    }
+    const componentName = match[1];
+    const constitution = await loadConstitution();
+    const filePath = path.join(SPEC_DIR, "components", `${componentName}.md`);
+    const content = await readFileDynamic(filePath);
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "text/markdown",
+                text: `${constitution}\n\n${content}`,
+            },
+        ],
+    };
+});
+/**
+ * 启动服务器
+ */
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // 输出到 stderr 避免干扰 stdio 协议
+    console.error("PDAKit MCP Server 已启动 (stdio 模式)");
+    console.error(`项目根目录: ${PROJECT_ROOT}`);
+    console.error(`规范目录: ${SPEC_DIR}`);
+}
+main().catch((error) => {
+    console.error("服务器启动失败:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map