@web_qiang/aform-mcp 0.0.1

package/README.md

@@ -0,0 +1,112 @@
+# @web_qiang/aform-mcp
+
+`@web_qiang/aform` 的 MCP 服务：把表单组件库的能力（组件查询、配置生成、字典检索）暴露给 LLM 客户端。基于 **MCP TypeScript SDK v2**（`@modelcontextprotocol/server` + `@modelcontextprotocol/node`）实现，同时支持 **stdio** 与 **Streamable HTTP** 两种传输。
+
+## 能力一览
+
+### Tools（工具）
+
+| 名称 | 说明 |
+| --- | --- |
+| `list_components` | 列出全部组件 / 控件，可按 `category` 过滤（`container`/`control`/`table`/`search`/`display`）。 |
+| `get_component_doc` | 查询某个组件 / 控件的说明与关键配置项（RawConfig 字段）。 |
+| `generate_form_config` | 根据字段清单生成 aform 的 `RawConfig` 配置数组（JSON）。 |
+| `search_dict` | 在内置字典中按关键词（label 或 value）模糊检索选项。 |
+| `list_control_types` | 列出全部「写控件」与「展示组件」类型名。 |
+| `list_dicts` | 列出全部内置字典名及其选项数量。 |
+| `get_control_snippet` | 为指定控件生成一段可运行的 Vue SFC 片段（AForm + 单个 configs 项）。 |
+
+### Resources（资源）
+
+客户端可像读文件一样读取知识库：
+
+- `aform://components` —— 全部组件清单（JSON）。
+- `aform://dicts` —— 全部内置字典选项（JSON）。
+- `aform://components/{name}` —— 单个组件详情（URI 模板，可在 `resources/list` 中枚举，如 `aform://components/AForm`）。
+
+### Prompts（提示词）
+
+| 名称 | 说明 |
+| --- | --- |
+| `generate-form` | 根据自然语言描述编排「查组件 → 选字典 → 生成配置」的流程。 |
+| `explain-component` | 讲解某组件配置项与用法示例。 |
+| `pick-dict` | 在字典中检索合适的选项，用于 select / radioGroup 等控件。 |
+
+## 开发
+
+```bash
+cd mcp
+pnpm install
+pnpm build        # tsc 编译到 dist/
+```
+
+## 运行
+
+### stdio（本地子进程，Claude Desktop / Cursor 等接入）
+
+```bash
+pnpm start:stdio
+```
+
+`bin` 已注册为 `aform-mcp`，也可直接：
+
+```bash
+node dist/stdio.js
+```
+
+### Streamable HTTP
+
+```bash
+PORT=3000 pnpm start:http
+# 端点：POST http://127.0.0.1:3000/mcp  （同时支持 JSON 与 SSE 响应）
+```
+
+HTTP 模式使用 v2 官方的 `createMcpHandler` + `@modelcontextprotocol/node` 的 `toNodeHandler`，并默认开启 `localhostHostValidation` / `localhostOriginValidation` 守卫，仅允许本机 Host 与 Origin，防止 DNS 重绑定与跨站请求。
+
+## 客户端接入示例
+
+### Claude Desktop（`claude_desktop_config.json`）
+
+```json
+{
+  "mcpServers": {
+    "aform": {
+      "command": "node",
+      "args": ["/绝对路径/form/mcp/dist/stdio.js"]
+    }
+  }
+}
+```
+
+### 用 MCP Inspector 调试
+
+```bash
+npx @modelcontextprotocol/inspector node ./dist/stdio.js
+# 或调试 HTTP 模式
+npx @modelcontextprotocol/inspector http://127.0.0.1:3000/mcp
+```
+
+## 目录结构
+
+```
+mcp/
+├── src/
+│   ├── index.ts       # 对外导出 createAformServer 与知识库
+│   ├── server.ts      # 装配 McpServer，注册 tools/resources/prompts
+│   ├── tools.ts       # 7 个工具
+│   ├── resources.ts   # 组件清单 / 字典 / 单组件详情资源
+│   ├── prompts.ts     # 3 个提示词
+│   ├── knowledge.ts   # aform 静态知识库（组件文档 + 示例字典）
+│   ├── stdio.ts       # stdio 传输入口（serveStdio）
+│   └── http.ts        # Streamable HTTP 传输入口
+├── package.json
+└── tsconfig.json
+```
+
+## 依赖说明
+
+- `@modelcontextprotocol/server`（v2）：MCP 服务端 SDK，提供 `McpServer` / `registerTool` / `registerResource` / `registerPrompt` / `serveStdio` / `createMcpHandler`。
+- `@modelcontextprotocol/node`（v2）：Node 适配，提供 `toNodeHandler` 与 Host/Origin 校验守卫。
+- `zod`（v4）：工具 / 提示词的参数 schema（`import * as z from 'zod/v4'`）。
+
+> 注：旧的 `@modelcontextprotocol/sdk`（v1）与 `express` 已被移除；v2 用 `createMcpHandler` + `toNodeHandler` 取代 v1 的 `SSEServerTransport` + `express` 方案。

package/dist/http.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/http.js

@@ -0,0 +1,23 @@
+import { createServer } from 'node:http';
+import { createMcpHandler } from '@modelcontextprotocol/server';
+import { toNodeHandler, localhostHostValidation, localhostOriginValidation, } from '@modelcontextprotocol/node';
+import { createAformServer } from './server.js';
+// v2 Streamable HTTP：每请求新建 McpServer 实例（无状态工厂）
+const handler = createMcpHandler(() => createAformServer());
+const nodeHandler = toNodeHandler(handler);
+// 防 DNS 重绑定 / 跨站：仅允许本机 Host 与 Origin
+const validateHost = localhostHostValidation();
+const validateOrigin = localhostOriginValidation();
+const PORT = Number(process.env.PORT ?? 3000);
+createServer((req, res) => {
+    if (!validateHost(req, res) || !validateOrigin(req, res))
+        return;
+    void nodeHandler(req, res);
+}).listen(PORT, '127.0.0.1', () => {
+    console.error(`aform-mcp HTTP (Streamable) server listening on http://127.0.0.1:${PORT}/mcp`);
+});
+process.on('SIGINT', async () => {
+    await handler.close();
+    process.exit(0);
+});
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C,+CAA+C;AAC/C,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAA;AAC3D,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;AAE1C,qCAAqC;AACrC,MAAM,YAAY,GAAG,uBAAuB,EAAE,CAAA;AAC9C,MAAM,cAAc,GAAG,yBAAyB,EAAE,CAAA;AAElD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAA;AAE7C,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACxB,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC;QAAE,OAAM;IAChE,KAAK,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;AAC5B,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;IAChC,OAAO,CAAC,KAAK,CAAC,oEAAoE,IAAI,MAAM,CAAC,CAAA;AAC/F,CAAC,CAAC,CAAA;AAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,OAAO,CAAC,KAAK,EAAE,CAAA;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { createAformServer } from './server.js';
+export { registerTools } from './tools.js';
+export { registerResources } from './resources.js';
+export { registerPrompts } from './prompts.js';
+export { COMPONENTS, DICTS, CONTROL_TYPES, DISPLAY_TYPES, DICT_NAMES, getComponentDoc, } from './knowledge.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+export { createAformServer } from './server.js';
+export { registerTools } from './tools.js';
+export { registerResources } from './resources.js';
+export { registerPrompts } from './prompts.js';
+export { COMPONENTS, DICTS, CONTROL_TYPES, DISPLAY_TYPES, DICT_NAMES, getComponentDoc, } from './knowledge.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EACL,UAAU,EACV,KAAK,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,gBAAgB,CAAA"}

package/dist/knowledge.d.ts

@@ -0,0 +1,28 @@
+/**
+ * aform 静态知识库。
+ *
+ * 当前为内置快照，足以驱动 MCP 工具；后续可改为直接读取 @web_qiang/aform 的
+ * 类型定义 / README 动态生成，避免与库版本脱节。
+ */
+export interface ComponentDoc {
+    /** 组件 / 控件名 */
+    name: string;
+    /** 分类：容器 / 控件 / 表格 / 搜索 / 展示 */
+    category: 'container' | 'control' | 'table' | 'search' | 'display';
+    /** 一句话说明 */
+    description: string;
+    /** 关键配置项（RawConfig 字段） */
+    config: string[];
+}
+export declare const COMPONENTS: ComponentDoc[];
+export declare const CONTROL_TYPES: string[];
+export declare const DISPLAY_TYPES: string[];
+/** 按名称（不区分大小写）查找组件文档 */
+export declare function getComponentDoc(name: string): ComponentDoc | undefined;
+/** 示例字典（与 demo 对齐），search_dict 工具按 label/value 模糊匹配 */
+export declare const DICTS: Record<string, {
+    label: string;
+    value: string;
+}[]>;
+/** 所有内置字典名（在 DICTS 声明之后，避免 TDZ） */
+export declare const DICT_NAMES: string[];

package/dist/knowledge.js

@@ -0,0 +1,193 @@
+/**
+ * aform 静态知识库。
+ *
+ * 当前为内置快照，足以驱动 MCP 工具；后续可改为直接读取 @web_qiang/aform 的
+ * 类型定义 / README 动态生成，避免与库版本脱节。
+ */
+export const COMPONENTS = [
+    {
+        name: 'AForm',
+        category: 'container',
+        description: '表单容器：v-model 绑定模型，按 configs 数组渲染栅格表单，下发表单级 state。',
+        config: ['modelValue', 'configs', 'column', 'state', 'gap', 'labelWidth', 'labelPosition', 'size', 'group', 'scope', 'overrideConfig'],
+    },
+    {
+        name: 'AFormItem',
+        category: 'container',
+        description: '单个表单项：可独立挂在原生 el-form 下，自动把 props 收敛成 prop、rules 收敛成校验器。',
+        config: ['config', 'model', 'prop', 'state', 'scope', 'from'],
+    },
+    {
+        name: 'ASearch',
+        category: 'search',
+        description: '搜索栏：与 AForm 同构的轻量表单，常用于表格顶部筛选，@search 抛出查询参数。',
+        config: ['modelValue', 'configs', 'column', 'state'],
+    },
+    {
+        name: 'ATable',
+        category: 'table',
+        description: '配置驱动的表格：列配置与表单配置同构，支持 request 异步分页、行内编辑、行级 state。',
+        config: ['configs', 'request', 'query', 'pageSize', 'pageNum', 'height', 'border', 'stripe', 'toolbar', 'empty'],
+    },
+    {
+        name: 'ATableColumn',
+        category: 'table',
+        description: '命令式列定义（备选方案），与 configs 数组写法二选一。',
+        config: ['config'],
+    },
+    {
+        name: 'AContent',
+        category: 'container',
+        description: '多控件容器：一个 label 下挂多个控件（content 数组），由 formItem 统一校验。',
+        config: ['configs', 'model', 'state'],
+    },
+    {
+        name: 'el-input',
+        category: 'control',
+        description: '文本输入（含 type=password/textarea、clearable、maxlength 等）。',
+        config: ['type', 'attrs', 'slots', 'rules', 'on'],
+    },
+    {
+        name: 'number',
+        category: 'control',
+        description: '自研数字控件：边输入边清洗 + 失焦格式化，attrs.unit 显示单位。',
+        config: ['attrs.min', 'attrs.max', 'attrs.precision', 'attrs.unit'],
+    },
+    {
+        name: 'price',
+        category: 'control',
+        description: '金额控件：复用 number，固定 2 位小数 + 千分位。',
+        config: ['attrs'],
+    },
+    {
+        name: 'radioGroup',
+        category: 'control',
+        description: '单选组，dict 提供选项，button=true 为按钮样式。',
+        config: ['dict', 'button', 'options.toString'],
+    },
+    {
+        name: 'checkboxGroup',
+        category: 'control',
+        description: '多选组，options.toString 指定存回模型的分隔符（默认逗号）。',
+        config: ['dict', 'button', 'options.toString'],
+    },
+    {
+        name: 'select',
+        category: 'control',
+        description: '下拉选择，dict 提供选项。',
+        config: ['dict', 'attrs', 'rules'],
+    },
+    {
+        name: 'cascader',
+        category: 'control',
+        description: '级联选择，dict 为带 children 的树。',
+        config: ['dict', 'attrs.emitPath'],
+    },
+    {
+        name: 'dict',
+        category: 'display',
+        description: '字典展示：把值按 dict 渲染成 ElTag，attrs.tagType 配颜色。',
+        config: ['dict', 'attrs.tagType', 'attrs.separator'],
+    },
+    {
+        name: 'date',
+        category: 'control',
+        description: '日期控件：按 attrs.type 自动处理 date/datetime/month/year/daterange。',
+        config: ['attrs.type', 'attrs.placeholder'],
+    },
+    {
+        name: 'el-rate',
+        category: 'control',
+        description: '评分。',
+        config: ['attrs.max', 'attrs.allowHalf', 'attrs.showText'],
+    },
+    {
+        name: 'el-slider',
+        category: 'control',
+        description: '滑块。',
+        config: ['attrs.min', 'attrs.max', 'attrs.showStops'],
+    },
+    {
+        name: 'el-switch',
+        category: 'control',
+        description: '开关。',
+        config: ['attrs'],
+    },
+    {
+        name: 'el-color-picker',
+        category: 'control',
+        description: '颜色选择。',
+        config: ['attrs'],
+    },
+    {
+        name: 'upload',
+        category: 'display',
+        description: '附件上传 / 只读态渲染为文件链接列表。',
+        config: ['attrs.limit', 'attrs.accept'],
+    },
+    {
+        name: 'tooltip',
+        category: 'display',
+        description: '带 hover 提示的展示组件。',
+        config: ['attrs.placement'],
+    },
+    {
+        name: 'format',
+        category: 'display',
+        description: '自定义渲染：format 返回字符串或 VNode（如计算列、操作列）。',
+        config: ['format', 'label'],
+    },
+    {
+        name: 'common',
+        category: 'display',
+        description: '纯文本展示，自动溢出 tooltip。',
+        config: ['label'],
+    },
+    {
+        name: 'empty',
+        category: 'display',
+        description: '空状态展示。',
+        config: ['label'],
+    },
+];
+export const CONTROL_TYPES = COMPONENTS.filter((c) => c.category === 'control').map((c) => c.name);
+export const DISPLAY_TYPES = COMPONENTS.filter((c) => c.category === 'display').map((c) => c.name);
+/** 按名称（不区分大小写）查找组件文档 */
+export function getComponentDoc(name) {
+    const key = name.toLowerCase();
+    return COMPONENTS.find((c) => c.name.toLowerCase() === key);
+}
+/** 示例字典（与 demo 对齐），search_dict 工具按 label/value 模糊匹配 */
+export const DICTS = {
+    sex: [
+        { label: '男', value: '1' },
+        { label: '女', value: '2' },
+    ],
+    priority: [
+        { label: '低', value: 'low' },
+        { label: '中', value: 'medium' },
+        { label: '高', value: 'high' },
+    ],
+    dept: [
+        { label: '产品部', value: 'product' },
+        { label: '研发部', value: 'rd' },
+        { label: '运营部', value: 'ops' },
+        { label: '市场部', value: 'market' },
+    ],
+    skill: [
+        { label: 'Vue', value: 'vue' },
+        { label: 'React', value: 'react' },
+        { label: 'TypeScript', value: 'ts' },
+        { label: 'Node.js', value: 'node' },
+        { label: 'Rust', value: 'rust' },
+    ],
+    orderStatus: [
+        { label: '待付款', value: '0' },
+        { label: '待发货', value: '1' },
+        { label: '已完成', value: '2' },
+        { label: '已取消', value: '3' },
+    ],
+};
+/** 所有内置字典名（在 DICTS 声明之后，避免 TDZ） */
+export const DICT_NAMES = Object.keys(DICTS);
+//# sourceMappingURL=knowledge.js.map

package/dist/knowledge.js.map

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

package/dist/prompts.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+/**
+ * 注册提示词（Prompts），用于把常见任务编排成可复用的对话起点：
+ * - generate-form：根据自然语言描述生成表单配置
+ * - explain-component：讲解某组件用法
+ * - pick-dict：在字典里挑选项
+ */
+export declare function registerPrompts(server: McpServer): void;

package/dist/prompts.js

@@ -0,0 +1,76 @@
+import * as z from 'zod/v4';
+import { DICT_NAMES } from './knowledge.js';
+/**
+ * 注册提示词（Prompts），用于把常见任务编排成可复用的对话起点：
+ * - generate-form：根据自然语言描述生成表单配置
+ * - explain-component：讲解某组件用法
+ * - pick-dict：在字典里挑选项
+ */
+export function registerPrompts(server) {
+    server.registerPrompt('generate-form', {
+        title: '生成表单配置',
+        description: '根据自然语言描述，产出 aform 的 RawConfig 配置数组。',
+        argsSchema: z.object({
+            description: z.string().describe('表单用途的自然语言描述，例如「一个员工信息录入表单」。'),
+            fields: z
+                .string()
+                .optional()
+                .describe('可选：逗号分隔的字段清单提示，例如「姓名, 性别, 部门, 入职日期」。'),
+        }),
+    }, ({ description, fields }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `请为以下需求生成 aform 表单配置：\n\n` +
+                        `需求：${description}\n` +
+                        (fields ? `已知字段：${fields}\n` : '') +
+                        `\n要求：\n` +
+                        `1. 先用 list_components / get_component_doc 确认每个字段该用哪个 type；\n` +
+                        `2. 需要下拉 / 单选 / 多选时，先用 list_dicts 查看有哪些字典，再用 search_dict 检索合适选项，把选项填进 dict；\n` +
+                        `3. 最后调用 generate_form_config 工具，传入字段数组，输出 RawConfig JSON。`,
+                },
+            },
+        ],
+    }));
+    server.registerPrompt('explain-component', {
+        title: '讲解组件',
+        description: '讲解某组件 / 控件的配置项与用法示例。',
+        argsSchema: z.object({
+            name: z.string().describe('组件或控件名，如 AForm、number、dict。'),
+        }),
+    }, ({ name }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `请调用 get_component_doc 工具查询「${name}」的配置项，并用中文讲解它的作用、关键 config 字段，以及一个最小使用示例。`,
+                },
+            },
+        ],
+    }));
+    server.registerPrompt('pick-dict', {
+        title: '挑选字典选项',
+        description: '在 aform 内置字典中检索合适的选项，用于 select / radioGroup 等控件。',
+        argsSchema: z.object({
+            keyword: z.string().describe('要匹配的关键词（label 或 value 的子串）。'),
+            dict: z
+                .string()
+                .optional()
+                .describe(`可选：限定字典名，如 ${DICT_NAMES.slice(0, 3).join(' / ')}。不填则在全部字典中检索。`),
+        }),
+    }, ({ keyword, dict }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `请在${dict ? `「${dict}」字典` : '全部内置字典（含 ' + DICT_NAMES.join('、') + '）'}中检索与「${keyword}」相关的选项，并给出可直接填进控件 dict 字段的 [{label,value}] 数组。`,
+                },
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAgC,MAAM,gBAAgB,CAAA;AAEzE;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,cAAc,CACnB,eAAe,EACf;QACE,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,qCAAqC;QAClD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC/D,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,sCAAsC,CAAC;SACpD,CAAC;KACH,EACD,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAC5B,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EACF,0BAA0B;wBAC1B,MAAM,WAAW,IAAI;wBACrB,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClC,SAAS;wBACT,8DAA8D;wBAC9D,8EAA8E;wBAC9E,2DAA2D;iBAC9D;aACF;SACF;KACF,CAAC,CACH,CAAA;IAED,MAAM,CAAC,cAAc,CACnB,mBAAmB,EACnB;QACE,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,sBAAsB;QACnC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;SACzD,CAAC;KACH,EACD,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACb,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,8BAA8B,IAAI,2CAA2C;iBACpF;aACF;SACF;KACF,CAAC,CACH,CAAA;IAED,MAAM,CAAC,cAAc,CACnB,WAAW,EACX;QACE,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,kDAAkD;QAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC3D,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,cAAc,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;SAC7E,CAAC;KACH,EACD,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACtB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,KACJ,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAC9D,QAAQ,OAAO,gDAAgD;iBAChE;aACF;SACF;KACF,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/server';
+/**
+ * 注册 aform 知识库资源：让客户端可以像读文件一样读取组件清单、字典与单组件文档。
+ * - 静态资源：aform://components、aform://dicts
+ * - 资源模板：aform://components/{name}（可在 resources/list 中枚举）
+ */
+export declare function registerResources(server: McpServer): void;

package/dist/resources.js

@@ -0,0 +1,68 @@
+import { ResourceTemplate } from '@modelcontextprotocol/server';
+import { COMPONENTS, DICTS, getComponentDoc } from './knowledge.js';
+/**
+ * 注册 aform 知识库资源：让客户端可以像读文件一样读取组件清单、字典与单组件文档。
+ * - 静态资源：aform://components、aform://dicts
+ * - 资源模板：aform://components/{name}（可在 resources/list 中枚举）
+ */
+export function registerResources(server) {
+    server.registerResource('components', 'aform://components', {
+        title: '组件清单',
+        description: 'aform 全部组件 / 控件的结构化清单（名称、分类、说明）。',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'application/json',
+                text: JSON.stringify(COMPONENTS.map((c) => ({
+                    name: c.name,
+                    category: c.category,
+                    description: c.description,
+                    config: c.config,
+                })), null, 2),
+            },
+        ],
+    }));
+    server.registerResource('dicts', 'aform://dicts', {
+        title: '内置字典',
+        description: 'aform 内置示例字典（sex / priority / dept / skill / orderStatus 等）的全部选项。',
+        mimeType: 'application/json',
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'application/json',
+                text: JSON.stringify(DICTS, null, 2),
+            },
+        ],
+    }));
+    server.registerResource('component', new ResourceTemplate('aform://components/{name}', {
+        list: async () => ({
+            resources: COMPONENTS.map((c) => ({
+                uri: `aform://components/${c.name}`,
+                name: c.name,
+                description: c.description,
+            })),
+        }),
+    }), {
+        title: '组件详情',
+        description: '单个组件 / 控件的完整文档（含 RawConfig 配置项）。',
+        mimeType: 'application/json',
+    }, async (uri, { name }) => {
+        const doc = getComponentDoc(Array.isArray(name) ? name[0] : name);
+        if (!doc) {
+            throw new Error(`未找到组件「${name}」`);
+        }
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(doc, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAEnE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,gBAAgB,CACrB,YAAY,EACZ,oBAAoB,EACpB;QACE,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,kCAAkC;QAC/C,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACrB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;iBACjB,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC,CACH,CAAA;IAED,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,eAAe,EACf;QACE,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,mEAAmE;QAChF,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;aACrC;SACF;KACF,CAAC,CACH,CAAA;IAED,MAAM,CAAC,gBAAgB,CACrB,WAAW,EACX,IAAI,gBAAgB,CAAC,2BAA2B,EAAE;QAChD,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACjB,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAChC,GAAG,EAAE,sBAAsB,CAAC,CAAC,IAAI,EAAE;gBACnC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC,CAAC;SACJ,CAAC;KACH,CAAC,EACF;QACE,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,kCAAkC;QAC/C,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtB,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;QACjE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG,CAAC,CAAA;QACnC,CAAC;QACD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;iBACnC;aACF;SACF,CAAA;IACH,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/server';
+/**
+ * 创建一个配置好 aform 全部能力的 McpServer（v2 高阶层 API）。
+ * tools / resources / prompts 分别在各模块中注册，这里负责装配。
+ */
+export declare function createAformServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,17 @@
+import { McpServer } from '@modelcontextprotocol/server';
+import { registerTools } from './tools.js';
+import { registerResources } from './resources.js';
+import { registerPrompts } from './prompts.js';
+const VERSION = '0.0.1';
+/**
+ * 创建一个配置好 aform 全部能力的 McpServer（v2 高阶层 API）。
+ * tools / resources / prompts 分别在各模块中注册，这里负责装配。
+ */
+export function createAformServer() {
+    const server = new McpServer({ name: '@web_qiang/aform-mcp', version: VERSION });
+    registerTools(server);
+    registerResources(server);
+    registerPrompts(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,MAAM,OAAO,GAAG,OAAO,CAAA;AAEvB;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAEhF,aAAa,CAAC,MAAM,CAAC,CAAA;IACrB,iBAAiB,CAAC,MAAM,CAAC,CAAA;IACzB,eAAe,CAAC,MAAM,CAAC,CAAA;IAEvB,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/stdio.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/stdio.js

@@ -0,0 +1,9 @@
+import { serveStdio } from '@modelcontextprotocol/server/stdio';
+import { createAformServer } from './server.js';
+// serveStdio 拥有传输层，每次连接调用工厂构建实例；stdout 仅承载 JSON-RPC，日志走 stderr
+const handle = serveStdio(() => createAformServer());
+console.error('aform-mcp stdio server running');
+process.on('SIGINT', () => {
+    void handle.close();
+});
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C,+DAA+D;AAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAA;AAEpD,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAA;AAE/C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAA;AACrB,CAAC,CAAC,CAAA"}

package/dist/tools.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+/**
+ * 注册 aform 的全部工具（v2 高层 API）。
+ * 每个工具用 zod/v4 声明 inputSchema，handler 返回 { content: [...] }。
+ */
+export declare function registerTools(server: McpServer): void;

package/dist/tools.js

@@ -0,0 +1,175 @@
+import * as z from 'zod/v4';
+import { COMPONENTS, DICTS, DISPLAY_TYPES, CONTROL_TYPES, DICT_NAMES, getComponentDoc, } from './knowledge.js';
+/**
+ * 注册 aform 的全部工具（v2 高层 API）。
+ * 每个工具用 zod/v4 声明 inputSchema，handler 返回 { content: [...] }。
+ */
+export function registerTools(server) {
+    server.registerTool('list_components', {
+        title: '列出组件',
+        description: '列出 @web_qiang/aform 支持的所有组件 / 控件名（AForm、ATable、各类控件与展示组件）。可按 category 过滤。',
+        inputSchema: z.object({
+            category: z
+                .enum(['container', 'control', 'table', 'search', 'display'])
+                .optional()
+                .describe('可选：按分类过滤。'),
+        }),
+    }, async ({ category }) => {
+        const list = category
+            ? COMPONENTS.filter((c) => c.category === category)
+            : COMPONENTS;
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(list.map((c) => ({
+                        name: c.name,
+                        category: c.category,
+                        description: c.description,
+                    })), null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool('get_component_doc', {
+        title: '查询组件文档',
+        description: '查询某个组件 / 控件的说明与关键配置项（RawConfig 字段）。',
+        inputSchema: z.object({
+            name: z.string().describe('组件或控件名，如 AForm、number、dict。'),
+        }),
+    }, async ({ name }) => {
+        const doc = getComponentDoc(name);
+        if (!doc) {
+            throw new Error(`未找到组件「${name}」。可用：${COMPONENTS.map((c) => c.name).join(', ')}`);
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(doc, null, 2) }] };
+    });
+    server.registerTool('generate_form_config', {
+        title: '生成表单配置',
+        description: '根据字段清单生成 aform 的 RawConfig 配置数组（JSON）。',
+        inputSchema: z.object({
+            fields: z
+                .array(z.object({
+                label: z.string().optional().describe('标签文字。'),
+                props: z.string().describe('模型字段名。'),
+                type: z.string().optional().describe('控件类型，默认 el-input。'),
+                required: z.boolean().optional().describe('是否必填。'),
+                dict: z
+                    .array(z.object({ label: z.string(), value: z.string() }))
+                    .optional()
+                    .describe('选项列表 [{label,value}]，用于 select/radioGroup 等。'),
+            }))
+                .describe('字段清单。'),
+        }),
+    }, async ({ fields }) => {
+        const configs = fields.map((f) => {
+            const cfg = {
+                label: f.label ?? f.props,
+                props: f.props,
+                type: f.type ?? 'el-input',
+            };
+            if (f.required)
+                cfg.rules = true;
+            if (Array.isArray(f.dict))
+                cfg.dict = f.dict;
+            return cfg;
+        });
+        return { content: [{ type: 'text', text: JSON.stringify(configs, null, 2) }] };
+    });
+    server.registerTool('search_dict', {
+        title: '检索字典',
+        description: '在 aform 内置示例字典中按关键词（label 或 value）模糊检索选项。',
+        inputSchema: z.object({
+            keyword: z.string().describe('匹配 label 或 value 的子串。'),
+            dict: z
+                .string()
+                .optional()
+                .describe('可选：限定字典名（如 sex / priority / dept）。'),
+        }),
+    }, async ({ keyword, dict }) => {
+        const kw = keyword.toLowerCase();
+        const scope = dict ? { [dict]: DICTS[dict] ?? [] } : DICTS;
+        const hits = {};
+        for (const [dictName, items] of Object.entries(scope)) {
+            const matched = items.filter((i) => i.label.toLowerCase().includes(kw) || i.value.toLowerCase().includes(kw));
+            if (matched.length)
+                hits[dictName] = matched;
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(hits, null, 2) }] };
+    });
+    server.registerTool('list_control_types', {
+        title: '列出控件类型',
+        description: '列出所有可用的「写控件」与「展示组件」类型名，便于生成配置时选用。',
+        inputSchema: z.object({}),
+    }, async () => {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({ control: CONTROL_TYPES, display: DISPLAY_TYPES }, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool('list_dicts', {
+        title: '列出字典',
+        description: '列出全部内置字典名及其选项数量，便于用 search_dict 检索前先了解有哪些字典。',
+        inputSchema: z.object({}),
+    }, async () => {
+        const summary = DICT_NAMES.map((name) => ({
+            name,
+            count: DICTS[name].length,
+        }));
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(summary, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool('get_control_snippet', {
+        title: '生成控件片段',
+        description: '为指定控件类型生成一段可运行的 Vue SFC 片段（AForm + 单个 configs 项），演示如何在表单中挂载该控件。',
+        inputSchema: z.object({
+            type: z
+                .string()
+                .describe('控件 / 展示组件类型名，如 el-input、select、dict、number。'),
+        }),
+    }, async ({ type }) => {
+        return { content: [{ type: 'text', text: buildSnippet(type) }] };
+    });
+}
+/** 生成一个最小可运行的 Vue SFC 片段，演示把某控件挂到 AForm 上 */
+function buildSnippet(type) {
+    const doc = getComponentDoc(type);
+    if (!doc) {
+        throw new Error(`未知控件类型「${type}」。可用：${[...CONTROL_TYPES, ...DISPLAY_TYPES].join(', ')}`);
+    }
+    const isDict = doc.config.some((k) => k === 'dict' || k.startsWith('dict'));
+    const cfg = {
+        label: doc.name,
+        props: 'field',
+        type: doc.name,
+    };
+    if (isDict) {
+        cfg.dict = [
+            { label: '选项一', value: '1' },
+            { label: '选项二', value: '2' },
+        ];
+    }
+    const configsJson = JSON.stringify([cfg], null, 2);
+    return `<template>
+  <AForm v-model="form" :configs="configs" />
+</template>
+
+<script setup lang="ts">
+import { reactive } from 'vue'
+import { AForm } from '@web_qiang/aform'
+
+const form = reactive<Record<string, unknown>>({})
+const configs = ${configsJson}
+</script>`;
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@web_qiang/aform-mcp",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "MCP server for @web_qiang/aform: 组件查询、配置生成与字典检索（stdio + Streamable HTTP 双传输，基于 @modelcontextprotocol/server v2）。",
+  "license": "MIT",
+  "author": "web_qiang",
+  "bin": {
+    "aform-mcp": "./dist/stdio.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start:stdio": "node dist/stdio.js",
+    "start:http": "node dist/http.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/node": "^2.0.0",
+    "@modelcontextprotocol/server": "^2.0.0",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.2",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}