@xw-mcp/lcd-builder-mcp

公司内部前端 MCP Server。

安装方式

不需要手动安装，推荐通过 npx 使用。

Cursor 配置

在项目根目录创建 .cursor/mcp.json：

{
  "mcpServers": {
    "lcd-builder-mcp": {
      "command": "npx",
      "args": ["-y", "@xw-mcp/lcd-builder-mcp"]
    }
  }
}

Codex配置

codex mcp add lcd-builder-mcp -- npx -y @xw-mcp/lcd-builder-mcp

根据 Markdown 创建故事板

lcd_create_storyboard_from_md 读取 lcd-storyboard-config-md 标准模板生成的配置文档，并完成以下工作：

1. 校验故事板内容、变量、数据集字段、图表类型与全局配置；
2. 在写入前按名称唯一匹配已存在的平台数据集，并校验被引用字段；
3. 创建 storyboard 应用，导入数据集，创建图表目录和图表；
4. 保存变量、CKEditor 正文、显示、导航与导出配置；
5. 回读配置、树和图表预览，返回应用、数据集、模型及图表真实 ID。

输入参数：

• mdFilePath：必填，故事板 Markdown 配置文件路径；
• parentId：可选，应用目录 ID，默认 root；
• apiBaseUrl：可选，未传时使用 lcd_init_config 初始化的地址；
• token：可选，LCD xtoken，未传时使用全局配置。

动态数据故事板引用的平台数据集必须提前创建、可正常预览且名称唯一。本工具不会执行 Markdown 内 SQL，也不会自动创建数据集。写入中途失败时不会自动删除已创建资源；错误文本会包含阶段、应用 ID、已导入数据集和已创建图表节点，便于安全检查。

成功结果的 structuredContent 包含 appInstanceId、appInstanceName、datasets、charts、各类配置数量、verification 回读摘要、designerUrl、previewUrl 和 warnings。其中数据集与图表映射同时返回公共 datasetId、当前故事板的 modelId，图表映射另返回真实 chartId。

示例：

{ "mdFilePath": "D:/design/sales-storyboard.md" }

{
  "mdFilePath": "D:/design/quarterly-storyboard.md",
  "parentId": "report-directory-id"
}

{
  "mdFilePath": "D:/design/customer-storyboard.md",
  "apiBaseUrl": "http://localhost:18086",
  "token": "<xtoken>"
}

根据 DSL 创建工作流

lcd_create_flow_from_dsl 消费 lcd-flow-config-dsl 根据已确认工作流 Markdown 生成的严格 .dsl.json，并完成：

1. 在写入前校验阻塞 TODO、依赖 ID、节点拓扑、分支/监听器引用、BPMN 文件和条件公式；
2. 创建 flow_app 应用容器并保存流程基础配置、节点、办理人、权限、按钮、抄送和 SQL 监听器；
3. 回读真实 flowId，按 DSL 设置流程状态；
4. 创建流程数据查询表格，将 taskScope 转成平台内置 dataType 过滤条件；
5. 回读流程与查询表格，返回真实应用、流程和表格 ID 及验证摘要。

执行前会通过 LCD 表单接口确认 formId 是当前环境中已存在的智能表单。工作流配置、流程实例、待办/已办和引擎运行数据均由 LCD 平台库管理；智能表单底表可以位于任意注册业务数据源，执行器不会把该业务数据源当作流程库，也不会要求二者处于同一数据库实例。

配置设计阶段可用只读工具 lcd_list_data_source_tables 在 LCD 注册业务数据源中按名称/关键词定位真实表或视图，再创建数据集并绑定智能表单。该工具不创建资源，也不用于查询工作流运行表。

输入参数：

• dslFilePath：必填，lcd-flow-config-dsl 生成的 Flow DSL JSON 文件路径；
• parentId：可选，显式应用目录 ID；未传时按 DSL 的业务目录创建或解析；
• apiBaseUrl：可选，未传时优先读取 DSL 的非占位连接地址或全局配置；
• token：可选，LCD xtoken，未传时优先读取 DSL 的非占位 token 或全局配置。

DSL 中存在 blocking=true 的待确认项时工具会拒绝执行。工具不会创建绑定表单、人员、角色、数据集或数据源；这些依赖必须已存在并提供真实 ID。写入中途失败时不会自动删除资源，错误结果会列出当前步骤和已创建 ID。

file 流程必须提供内联 flowDefinitionXml 或可读取的 flowDefinitionFile。仅提供历史 flowDefinitionId 不能导入流程定义；该字段只作为来源追踪信息，实际创建与部署以后端保存的 BPMN XML 为准。

示例：

{
  "dslFilePath": "D:/design/expense-approval.dsl.json",
  "apiBaseUrl": "http://localhost:18086",
  "token": "<xtoken>"
}