pit-docs-mcp 1.0.2

package/README.md

@@ -0,0 +1,180 @@
+# PIT Docs MCP Server
+
+MCP (Model Context Protocol) 服务，用于将公司内部的 Vue 组件文档和规范文档暴露给 AI，使其在编写前端代码时能够参考内部最佳实践和 API 规范。
+
+**pit-xxx** 和 **el-xxx** 为内部私有组件，互联网上无任何官方文档，此 MCP 是查询其用法、Props、Events、Slots 的**唯一途径**。
+
+## 功能
+
+1. **Tools（工具）**：提供 4 个工具供 AI 查询组件文档和代码生成规范。
+2. **Resources（Resource Templates）**：通过 `pit-docs:///` URI 将文档作为只读资源暴露。
+3. **Prompts（提示）**：提供 2 个 Prompt，引导 AI 正确使用 pit 组件及生成后台管理页面。
+
+## 支持的库
+
+| 库名 | 说明 |
+|-----|------|
+| **pitBusinessUi** | 业务组件（如 pit-table、pit-dic、pit-document-preview） |
+| **pitElementUi** | 基础 UI 组件（如 el-form-base、el-upload-table） |
+| **pitBusinessUtils** | 工具函数（如 formValidate、auth、request） |
+
+## 工具说明
+
+### search_docs
+
+在文档中按关键字搜索。**涉及任何 pit-xxx 或 el-xxx 组件时，必须先调用此工具**。
+
+| 参数 | 类型 | 默认 | 说明 |
+|-----|------|------|------|
+| `keyword` | string | 必填 | 组件名或关键词，如 `pit-table`、`el-form-base`。多词空格分隔（OR 匹配） |
+| `maxResults` | number | 20 | 最大返回条数 |
+| `contextLines` | number | 3 | 每行匹配的上下文行数 |
+
+### read_doc
+
+读取组件文档全文。当 `search_docs` 返回的片段不足以完整回答时使用。
+
+| 参数 | 类型 | 说明 |
+|-----|------|------|
+| `pathOrUri` | string | 文档相对路径（如 `pitBusinessUi/table.md`）或完整 URI（如 `pit-docs:///pitBusinessUi/table.md`） |
+
+### list_docs
+
+列出可用组件文档目录，便于浏览或不确定组件准确名称时使用。
+
+| 参数 | 类型 | 默认 | 说明 |
+|-----|------|------|------|
+| `category` | string | 可选 | 按库筛选：`pitBusinessUi`、`pitElementUi`、`pitBusinessUtils` |
+| `offset` | number | 0 | 分页偏移 |
+| `limit` | number | 50 | 每页数量 |
+
+### get_codegen_spec
+
+获取 pit-simplify-web 后台管理页面代码生成规范。**生成 CRUD/管理页面时，必须先调用此工具**。
+
+| 参数 | 类型 | 默认 | 说明 |
+|-----|------|------|------|
+| `pageType` | string | "all" | `standard`（标准 CRUD）、`left-tree`（左树右表）、`flow`（流程表单）、`all`（全部） |
+| `includeComponentDocs` | boolean | true | 是否包含相关组件的 Props/API 文档摘要 |
+
+## Resources
+
+通过 Resource Templates 暴露文档，URI 格式：`pit-docs:///pitBusinessUi/{component}.md`。
+
+- **pitBusinessUi**：`pit-docs:///pitBusinessUi/table.md` → pit-table
+- **pitElementUi**：`pit-docs:///pitElementUi/form-base.md` → el-form-base
+- **pitBusinessUtils**：`pit-docs:///pitBusinessUtils/validate.md` → pit-validate
+
+## Prompts
+
+在 Cursor 等客户端中可选择以下提示：
+
+1. **PIT Component Docs Lookup**：查询 pit-xxx / el-xxx 组件文档。引导 AI 在涉及内部组件时主动调用 search_docs → read_doc。
+2. **pit-simplify-web Page Code Generation**：生成 pit-simplify-web 后台管理页面。引导 AI 先调用 get_codegen_spec 获取规范，再按规范生成 CRUD/左树右表/流程表单页面。
+
+## 文档目录
+
+文档已内置在包内（`docs/` 目录）。默认使用包自带的文档，无需额外配置。
+
+若需使用外部文档目录，可通过环境变量 `DOCS_PATH` 自定义：
+
+```bash
+set DOCS_PATH=E:\my-docs
+pit-docs-mcp
+```
+
+## 安装与运行
+
+**从 npm 安装（推荐）：**
+
+```bash
+npm install -g pit-docs-mcp
+# 或 项目内安装
+npm install pit-docs-mcp
+```
+
+**从源码安装：**
+
+```bash
+git clone <repo>
+cd pit-docs
+npm install
+npm run build
+```
+
+**运行方式：**
+
+- 全局安装后：`pit-docs-mcp`
+- npx：`npx pit-docs-mcp`
+- 项目内：`node node_modules/pit-docs-mcp/dist/index.js`
+
+## Cursor 配置
+
+在 `%USERPROFILE%\.cursor\mcp.json` 的 `mcpServers` 中添加：
+
+```json
+{
+  "mcpServers": {
+    "pit-docs": {
+      "type": "command",
+      "command": "npx",
+      "args": ["pit-docs-mcp"]
+    }
+  }
+}
+```
+
+若使用全局安装：
+
+```json
+{
+  "mcpServers": {
+    "pit-docs": {
+      "type": "command",
+      "command": "pit-docs-mcp"
+    }
+  }
+}
+```
+
+若需使用外部文档目录：
+
+```json
+{
+  "mcpServers": {
+    "pit-docs": {
+      "type": "command",
+      "command": "npx",
+      "args": ["pit-docs-mcp"],
+      "env": {
+        "DOCS_PATH": "D:\\your-custom-docs"
+      }
+    }
+  }
+}
+```
+
+## 使用方式
+
+### 推荐工作流
+
+1. **查询组件**：`search_docs` → 若片段不足 → `read_doc` 传入返回的 URI
+2. **浏览组件**：`list_docs` 获取目录，再 `read_doc` 读取感兴趣文档
+3. **生成管理页**：`get_codegen_spec` 获取规范 → 收集用户信息（表结构、服务名等）→ 按规范生成代码 → 用 `search_docs` 补充组件细节
+
+### 组件名映射
+
+文档文件名与组件名的对应关系：`image.md` → pit-image，`form-base.md` → el-form-base，`dic.md` → pit-dic。
+
+## 支持的文档类型
+
+- `.md`, `.mdx` - Markdown
+- `.vue` - Vue 组件
+- `.ts`, `.tsx`, `.js`, `.jsx` - TypeScript/JavaScript
+- `.json` - JSON
+
+## 技术栈
+
+- TypeScript
+- @modelcontextprotocol/sdk
+- Zod

package/dist/codegen.d.ts

@@ -0,0 +1,5 @@
+export type PageType = "standard" | "left-tree" | "flow" | "all";
+export declare function loadCodegenSpec(): Promise<string>;
+export declare function extractSections(spec: string, pageType: PageType): string;
+export declare function getComponentDocs(pageType: PageType): Promise<string>;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;AAiEjE,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAGvD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CA6BxE;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAsB1E"}

package/dist/codegen.js

@@ -0,0 +1,112 @@
+import fs from "fs/promises";
+import path from "path";
+import { DOCS_PATH } from "./constants.js";
+import { getCachedFileContent, extractPropsSection } from "./utils.js";
+const BASE_COMPONENTS = [
+    { component: "el-form-base", docPath: "pitElementUi/form-base.md" },
+    { component: "pit-input", docPath: "pitBusinessUi/input.md" },
+    { component: "pit-textarea", docPath: "pitBusinessUi/textarea.md" },
+    { component: "pit-input-number", docPath: "pitBusinessUi/input-number.md" },
+    { component: "pit-dic", docPath: "pitBusinessUi/dic.md" },
+    { component: "pit-table-operation", docPath: "pitBusinessUi/table-operation.md" },
+    { component: "pit-upload-table", docPath: "pitBusinessUi/upload-table.md" },
+];
+const LEFT_TREE_COMPONENTS = [
+    { component: "el-layout-tree", docPath: "pitElementUi/layout-tree.md" },
+    { component: "el-layout-column", docPath: "pitElementUi/layout-column.md" },
+];
+const COMPONENT_MAP = {
+    standard: BASE_COMPONENTS,
+    "left-tree": [...BASE_COMPONENTS, ...LEFT_TREE_COMPONENTS],
+    flow: BASE_COMPONENTS,
+    all: [...BASE_COMPONENTS, ...LEFT_TREE_COMPONENTS],
+};
+const SPEC_REL_PATH = "codegen/pit-simplify-web.md";
+const SECTION_MARKERS = {
+    standard: [
+        { start: /^## 1\. /, stop: /^## 2-ext1\. / },
+        { start: /^## 2\. /, stop: /^## 2-ext1\. / },
+        { start: /^## 3\. /, stop: /^## 4\. / },
+        { start: /^## 4\. /, stop: /^## 5\. / },
+        { start: /^## 5\. /, stop: /^## 6\. / },
+        { start: /^## 6\. /, stop: /^## 7\. / },
+        { start: /^## 7\. /, stop: /^## 8\. / },
+        { start: /^## 8\. / },
+    ],
+    "left-tree": [
+        { start: /^## 1\. /, stop: /^## 2\. / },
+        { start: /^## 2-ext1\. Left-Tree/, stop: /^## 2-ext2\. / },
+        { start: /^## 3\. /, stop: /^## 4\. / },
+        { start: /^## 4\. /, stop: /^## 5\. / },
+        { start: /^## 5\. /, stop: /^## 6\. / },
+        { start: /^## 6\. /, stop: /^## 7\. / },
+        { start: /^## 7\. /, stop: /^## 8\. / },
+        { start: /^## 8\. / },
+    ],
+    flow: [
+        { start: /^## 1\. /, stop: /^## 2\. / },
+        { start: /^## 2-ext2\. Workflow/, stop: /^## 3\. / },
+        { start: /^## 3\. /, stop: /^## 4\. / },
+        { start: /^## 4\. /, stop: /^## 5\. / },
+        { start: /^## 5\. /, stop: /^## 6\. / },
+        { start: /^## 6\. /, stop: /^## 7\. / },
+        { start: /^## 7\. /, stop: /^## 8\. / },
+        { start: /^## 8\. / },
+    ],
+    all: [],
+};
+export async function loadCodegenSpec() {
+    const fullPath = path.join(DOCS_PATH, SPEC_REL_PATH);
+    return await fs.readFile(fullPath, "utf-8");
+}
+export function extractSections(spec, pageType) {
+    if (pageType === "all")
+        return spec;
+    const markers = SECTION_MARKERS[pageType];
+    if (!markers || markers.length === 0)
+        return spec;
+    const lines = spec.split("\n");
+    const collected = [];
+    for (const marker of markers) {
+        let capturing = false;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (!capturing && marker.start.test(line)) {
+                capturing = true;
+            }
+            if (capturing) {
+                if (marker.stop && marker.stop.test(line)) {
+                    break;
+                }
+                collected.push(line);
+            }
+        }
+        if (collected.length > 0 && collected[collected.length - 1] !== "") {
+            collected.push("");
+        }
+    }
+    return collected.join("\n").trim();
+}
+export async function getComponentDocs(pageType) {
+    const refs = COMPONENT_MAP[pageType] ?? COMPONENT_MAP.all;
+    const sections = [];
+    for (const ref of refs) {
+        try {
+            const content = await getCachedFileContent(ref.docPath);
+            const props = extractPropsSection(content);
+            if (props) {
+                sections.push(`### ${ref.component} (${ref.docPath})\n\n${props}`);
+            }
+            else {
+                const truncated = content.length > 2000
+                    ? content.slice(0, 2000) + "\n\n... (truncated — use read_doc to view full content)"
+                    : content;
+                sections.push(`### ${ref.component} (${ref.docPath})\n\n${truncated}`);
+            }
+        }
+        catch {
+            sections.push(`### ${ref.component}\n\n> Document not found: ${ref.docPath}`);
+        }
+    }
+    return sections.join("\n\n---\n\n");
+}

package/dist/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const VERSION: string;
+export declare const DEFAULT_DOCS_PATH: string;
+export declare const DOCS_PATH: string;
+export declare const RESOURCE_URI_PREFIX = "pit-docs://";
+export declare const DOC_EXTENSIONS: Set<string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AAC3C,eAAO,MAAM,iBAAiB,QAAwC,CAAC;AACvE,eAAO,MAAM,SAAS,QAA6C,CAAC;AACpE,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,cAAc,aAA0E,CAAC"}

package/dist/constants.js

@@ -0,0 +1,10 @@
+import { readFileSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(path.resolve(__dirname, "..", "package.json"), "utf-8"));
+export const VERSION = pkg.version;
+export const DEFAULT_DOCS_PATH = path.resolve(__dirname, "..", "docs");
+export const DOCS_PATH = process.env.DOCS_PATH || DEFAULT_DOCS_PATH;
+export const RESOURCE_URI_PREFIX = "pit-docs://";
+export const DOC_EXTENSIONS = new Set([".md", ".mdx", ".vue", ".ts", ".tsx", ".js", ".jsx", ".json"]);

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { VERSION, DOCS_PATH } from "./constants.js";
+import { registerResourceTemplates } from "./resources.js";
+import { registerTools } from "./tools.js";
+const server = new McpServer({
+    name: "pit-docs",
+    version: VERSION,
+}, {
+    instructions: `你可以通过此 MCP 服务查询 pitBusinessUi,pitElementUi和pitBusinessUtils三个内部 Vue 组件库的文档，以及获取 pit-simplify-web 后台管理页面的代码生成规范。
+【何时必须调用】
+- 当用户提到 pit-xxx（如 pit-table、pit-dialog、pit-image）或 el-xxx（如 el-form-base、el-upload-table）组件时
+- 当用户询问内部组件的 Props、Events、Slots、用法、示例时
+- 当你不确定某个 pit/el 组件的 API 时
+- 当用户要求生成后台管理 CRUD 页面（标准页面、左树右表页面、流程审批页面）时
+- 这些是公司内部组件，互联网和代码库中没有相关文档，唯一信息源就是此 MCP
+【文档查询】
+1. 先用 search_docs 搜索关键词（组件名或中文名）
+2. 若片段不足，用 read_doc 读取完整文档
+3. 若不确定组件名，先用 list_docs 列出目录
+【代码生成】
+当用户要求生成 pit-simplify-web 后台管理页面时，必须先调用 get_codegen_spec 获取编码规范和组件文档，然后严格按规范生成代码。支持三种页面类型：standard（标准CRUD）、left-tree（左树右表）、flow（流程表单）。`,
+});
+// 注册工具和资源模板
+registerTools(server);
+// 注册 Prompt
+server.registerPrompt("pit-docs-help", {
+    title: "PIT 组件文档查询",
+    description: "此 MCP 仅为 pitBusinessUi,pitElementUi和pitBusinessUtils三个内部组件库提供文档支持。选择此提示将引导 AI 主动检索相关文档。",
+}, async (_extra) => ({
+    messages: [
+        {
+            role: "user",
+            content: {
+                type: "text",
+                text: `此 MCP 仅服务 pitBusinessUi,pitElementUi和pitBusinessUtils 三个内部组件库的文档查询。当涉及 pit 组件（如 PitTable、PitButton、PitDialog、pit-document-preview 等）时，若对用法、API、Props 或最佳实践不确定，请务必通过 search_docs 或 resources 查询文档，不要凭猜测编写。
+
+【调用 search_docs 的规范】
+- 使用组件名或技术关键词（如 pit-image、props、v-model），勿用自然语言短语（如「属性」「怎么用」）。
+- 多关键词按 OR 语义匹配，如「pit-document-preview 参数」。
+- 提取组件名时剔除无关描述，只保留全称（如 pit-image、pit-dic）。
+- 若不确定组件拼写，先调用 list_docs（category 仅支持 pitBusinessUi,pitElementUi和pitBusinessUtils）获取列表。
+
+【重要】当 search_docs 片段不足以回答（如问「有哪些参数」）时，必须用 read_doc 传入 pit-docs:// URI 读取完整文档后再回答。`,
+            },
+        },
+    ],
+}));
+server.registerPrompt("pit-simplify-web-codegen", {
+    title: "pit-simplify-web 页面代码生成",
+    description: "当需要为 pit-simplify-web 项目生成后台管理 CRUD 页面时，选择此提示。AI 将按照内部编码规范生成标准页面（standard）、左树右表页面（left-tree）或流程表单页面（flow）。",
+}, async (_extra) => ({
+    messages: [
+        {
+            role: "user",
+            content: {
+                type: "text",
+                text: `你现在处于 pit-simplify-web 后台管理页面代码生成模式。请严格遵循以下工作流：
+
+【第一步：获取规范】
+在生成任何代码之前，必须先调用 get_codegen_spec 工具获取完整的编码规范和组件文档。
+- 标准 CRUD 页面：get_codegen_spec(pageType: "standard")
+- 左树右表页面：get_codegen_spec(pageType: "left-tree")
+- 流程表单页面：get_codegen_spec(pageType: "flow")
+- 不确定类型：get_codegen_spec(pageType: "all")
+
+【第二步：收集信息】
+用户通常会提供以下信息（若缺失则主动询问）：
+- 表结构 SQL（字段名、类型、是否必填、注释）
+- 服务名（service）和模块名（module）
+- 字典字段信息（哪些字段使用字典、字典编码）
+- 页面类型（标准/左树右表/流程）
+
+【第三步：生成代码】
+严格按规范生成以下文件：
+1. API 文件：src/api/projectLevel/{moduleName}.js
+2. 页面文件：src/views/projectLevel/{moduleName}/{moduleName}.vue
+3. 流程表单（若需要）：src/views/projectLevel/{moduleName}/{moduleName}Flow.vue
+
+【第四步：自检】
+生成后按规范的「验收基准」逐项检查。
+
+【注意】
+- 不要凭记忆编写 pit 组件用法，必须参考 get_codegen_spec 返回的组件文档
+- 若需要某个组件的更详细文档，使用 search_docs 或 read_doc 补充查阅
+- SQL 字段名（snake_case）必须转换为前端字段名（camelCase）`,
+            },
+        },
+    ],
+}));
+// 启动服务器
+async function runServer() {
+    console.error(`[pit-docs-mcp] 启动服务器 v${VERSION}`);
+    await registerResourceTemplates(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[pit-docs-mcp] MCP 服务已启动，文档目录:", DOCS_PATH);
+}
+// Graceful shutdown
+function shutdown() {
+    console.error("[pit-docs-mcp] 正在关闭服务...");
+    server.close().then(() => {
+        console.error("[pit-docs-mcp] 服务已关闭");
+        process.exit(0);
+    }).catch(() => {
+        process.exit(1);
+    });
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+runServer().catch((err) => {
+    console.error("[pit-docs-mcp] 启动失败:", err);
+    process.exit(1);
+});

package/dist/resources.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResourceTemplates(server: McpServer): Promise<void>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,yCAAyC,CAAC;AAUtF,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,SAAS,iBAoFhE"}

package/dist/resources.js

@@ -0,0 +1,80 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import fs from "fs/promises";
+import { DOCS_PATH, RESOURCE_URI_PREFIX } from "./constants.js";
+import { getComponentsInCategory, docNameToComponentName, pathToUri, safePath, } from "./utils.js";
+export async function registerResourceTemplates(server) {
+    try {
+        const stats = await fs.stat(DOCS_PATH);
+        if (!stats.isDirectory()) {
+            console.error(`[pit-docs-mcp] 文档路径不是目录: ${DOCS_PATH}`);
+            return;
+        }
+    }
+    catch (err) {
+        console.error(`[pit-docs-mcp] 文档目录不存在或不可访问: ${DOCS_PATH}`, err);
+        return;
+    }
+    const categories = ["pitBusinessUi", "pitElementUi", "pitBusinessUtils"];
+    for (const category of categories) {
+        const uriTemplate = `${RESOURCE_URI_PREFIX}/${category}/{component}.md`;
+        server.registerResource(`${category}-component-docs`, new ResourceTemplate(uriTemplate, {
+            list: async () => {
+                const components = await getComponentsInCategory(category);
+                const resources = components.map((component) => {
+                    const relPath = `${category}/${component}.md`;
+                    const uri = pathToUri(relPath);
+                    const componentName = docNameToComponentName(component, category);
+                    return {
+                        uri,
+                        name: componentName,
+                        description: `${componentName} 组件文档（内部文档，非外部网络文档）`,
+                        mimeType: "text/markdown",
+                    };
+                });
+                return { resources };
+            },
+            complete: {
+                component: async (value) => {
+                    const components = await getComponentsInCategory(category);
+                    const lower = value.toLowerCase();
+                    return components.filter((c) => c.toLowerCase().includes(lower)).slice(0, 20);
+                },
+            },
+        }), {
+            description: category === "pitBusinessUi"
+                ? "pitBusinessUi 组件文档。组件名称映射：image → pit-image，table → pit-table"
+                : category === "pitElementUi"
+                    ? "pitElementUi 组件文档。组件名称映射：form-base → el-form-base，dialog → el-dialog"
+                    : "pitBusinessUtils 工具函数文档。工具名称映射：validate → pit-validate，auth → pit-auth",
+            mimeType: "text/markdown",
+        }, async (uri, variables, _extra) => {
+            const component = typeof variables.component === "string" ? variables.component : variables.component?.[0];
+            if (!component || /[<>:"/\\|?*]/.test(component)) {
+                throw new Error(`无效的 component 参数: ${component}`);
+            }
+            const relPath = `${category}/${component}.md`;
+            const filePath = safePath(relPath);
+            try {
+                const content = await fs.readFile(filePath, "utf-8");
+                const fullUri = pathToUri(relPath);
+                return {
+                    contents: [
+                        {
+                            uri: fullUri,
+                            mimeType: "text/markdown",
+                            text: content,
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                throw new Error(`无法读取文档 pit-docs:///${relPath}: ${msg}`);
+            }
+        });
+    }
+    const totalComponents = (await getComponentsInCategory("pitBusinessUi")).length +
+        (await getComponentsInCategory("pitElementUi")).length +
+        (await getComponentsInCategory("pitBusinessUtils")).length;
+    console.error(`[pit-docs-mcp] 已注册 3 个 Resource Templates，共 ${totalComponents} 个文档`);
+}

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,QAK9C"}