使用 DX MCP 工具进行 LWC 开发（Beta）
Beta 服务——受 Beta Services Terms 约束。MCP 工具使用生成式 AI，输出可能不准确——使用前需审查。
Salesforce DX MCP（Model Context Protocol）工具为 LWC 提供 AI 驱动的开发、测试、优化能力——代码智能、上下文感知建议、Salesforce 元数据集成。推荐通过 Agentforce Vibes Extension（预配置最完整体验）使用，也可用于 Cursor/VS Code+Copilot。四个工具默认启用：guide_lwc_development、orchestrate_lwc_component_creation、guide_component_accessibility、create_lwc_component。必须启用两个全局规则：a4d-general-rules-no-edit.md（默认）+ a4d-lwc-rules-no-edit.md。
配置与三个工具集概述
MCP 服务器配置（mcpServers JSON）：
{
"mcpServers": {
"Salesforce DX": {
"command": "npx",
"args": ["-y", "@salesforce/mcp@latest", "--orgs", "DEFAULT_TARGET_ORG",
"--toolsets", "lwc-experts,aura-experts,experts-validation"]
}
}
}
// --toolsets 启用整个工具集 | --tools 启用单个工具（逗号分隔）
// --allow-non-ga-tools 启用非 GA 工具三个工具集：
| 工具集 | 用途 | 工具数 |
|---|---|---|
| lwc-experts | LWC 开发/测试/优化/最佳实践/SLDS/LDS/基础组件/Figma/安全/迁移 | 34 |
| aura-experts | Aura-to-LWC 迁移（蓝图/PRD/编排） | 4 |
| experts-validation | 生产就绪度验证和评分（0-100） | 2 |
LWC 和 Aura 工具集分析：组件结构和层次、事件处理模式、数据绑定方式、自定义接口和依赖、第三方集成。生成详细迁移方案：依赖分析+转换顺序、复杂组件风险评估、每组件时间估算、兼容性考量。
LWC 开发工具 —— 创建、最佳实践与无障碍
13 个开发工具——GA 和非 GA：
| 工具 | GA | 功能 |
|---|---|---|
| guide_lwc_development | ✅ | 端到端开发工作流和实现指南 |
| guide_lwc_best_practices | ✅ | 最佳实践和编码标准——识别反模式并建议替代 |
| create_lwc_component_from_prd | ✅ | 从 PRD 规范创建完整组件——可链式调用 Figma/优化/测试/LDS 工具 |
| orchestrate_lwc_component_creation | ✅ | 逐步组件创建指导——从需求收集到测试 |
| orchestrate_lwc_component_optimization | ✅ | 性能优化——TTI/CPU/paint/memory 检查清单 |
| guide_component_accessibility | ✅ | 无障碍指南——ARIA/keyboard 清单+代码修复示例 |
| guide_lwc_rtl_support | ✅ | RTL 国际化——CSS 逻辑属性转换 |
| reference_lwc_compilation_error | ✅ | 编译错误参考——LWC1034/LWC1011 等错误码解析 |
| explore_slds_blueprints | ❌ | SLDS 蓝图检索——按名称/类别/组件/SLDS类/样式钩子筛选 |
| explore_slds_styling | ❌ | 样式钩子探索——精确/前缀/通配符/模糊匹配+按类别/子类别/类型筛选 |
| guide_slds_blueprints | ❌ | SLDS 蓝图完整指南——按类别组织的完整索引 |
| guide_slds_styling | ❌ | 样式钩子完整指南——颜色/间距/排版/尺寸/边框/阴影分类 |
| orchestrate_lwc_slds2_uplift | ❌ | SLDS 2 迁移——识别硬编码颜色/类覆盖/废弃令牌→建议替换 |
典型提示词模式："Review this component for LWC best practices"、"Create an LWC component named accountList from this PRD"、"Outline step-by-step tasks to build a contact list component"、"Review this component for accessibility and list concrete fixes"、"How do I fix error code LWC1034?"、"What is .slds-button.slds-button_icon?"、"What styling hooks start with --slds-g-color-error?"。
测试、基础组件与 LDS MCP 工具
测试工具（5个）：orchestrate_lwc_component_testing（测试计划+生成）、create_lwc_jest_tests（覆盖 load/success/empty/error 状态+wire mock+DOM 断言）、review_lwc_jest_tests（验证最佳实践+异步处理+覆盖缺口）、run_lwc_accessibility_jest_tests（焦点顺序/ARIA 角色/键盘导航 Jest 集成）、guide_utam_generation（❌非GA——UTAM Page Object 生成）。
基础组件工具（2个——两步模式）：guide_lbc_usage（先——识别候选组件→"Are there base components for layout?"）→ explore_lbc_components（后——提供属性/事件/插槽完整指南+使用示例）。仅支持 Lightning Component Reference 中的基础组件——不支持旧版 Aura 组件。
LDS 工具（10个——全部 GA）：
- 数据指南：guide_lds_development（选择 base components vs custom LDS wires/record editor 清单/性能技巧）、guide_lds_data_consistency（getRecordNotifyChange 同步/并发编辑策略/缓存失效规则）、guide_lds_referential_integrity（防孤立记录/查找验证/软删除处理）
- UI API：explore_lds_uiapi（列出 wire adapter/字段 schema/命令式 vs wired 对比）、orchestrate_lds_data_requirements（对象-字段-关系-操作-安全-离线 PRD 规格→调用 explore_lds_uiapi+guide_lds_graphql）
- GraphQL 工作流（四步链）：guide_lds_graphql（设计查询→提示选择 introspection 方法：手动/ConnectAPI/CLI→必须 introspection 避免无效字段名）→ fetch_lds_graphql_schema（获取静态 schema/类型/枚举/指令）→ create_lds_graphql_read_query / create_lds_graphql_mutation_query（生成查询/变更）→ test_lds_graphql_query（连接 org 测试查询——仅由前两个工具调用）
Figma to LWC（1个 GA）：guide_figma_to_lwc_conversion——需要 Figma access token（file_content:read 权限）+ Framelink MCP Server。三步：获取 Token→连接 Framelink→发送 Prompt（转换设计/提取设计 Token/生成组件分解）。工具自动分析：组件层次/布局模式/排版间距/配色主题/交互元素→生成 LWC 代码+SLDS 集成 CSS+响应式模式+无障碍属性。
迁移、安全与验证工具
迁移验证工具（2个——全部 GA）：verify_aura_migration_completeness（审计 Aura→LWC 转换完整性——评估功能/UI 等价性、事件、数据绑定、模块化、错误处理、本地化、安全性、性能九维度→生成清单+完整度评分）和 guide_lo_migration（Lightning Out Beta→2.0 迁移指南——架构/生命周期/事件/样式推荐）。
LWS 安全工具（1个 GA）：guide_lws_security——分析组件安全风险：XSS/DOM 注入（lwc:dom="manual"+innerHTML）/CRUD 安全清单（FLS/WITH SHARING/SOQL 注入/输入验证）/第三方库审计（LWS+CSP 合规+安全集成模式）。
Aura-to-LWC 迁移工具（4个——全部 GA——aura-experts 工具集）：
- 编排式迁移（推荐）：orchestrate_aura_migration 一次性运行全流程：Draft PRD→Enhance→Confirm→Generate LWC→Optimize & Test。适合中小型自包含 Aura 组件
- 受控迁移（分步）：create_aura_blueprint_draft（分析 Aura→框架无关 PRD YAML）→ enhance_aura_blueprint_draft（解决未知/添加 SLDS 指导/可测试验收标准）→ transition_prd_to_lwc（LWC 组件分解/文件脚手架/wire+事件映射/Aura 模式→LWC 等价物）→ create_lwc_component_from_prd（生成代码）。适合需迭代对齐利益相关者的场景
使用建议：包含完整的 Aura bundle（部分输入降低 PRD 质量）、明确事件 payload 和公共 API 和跨组件通信（提高生成质量）、蓝图迭代多次后再分发创建。
验证工具（2个——Developer Preview——experts-validation 工具集）：
validate_and_optimize 运行五个验证器：Code Analyzer + Accessibility + Security(LWS) + Data(LDS consistency) + LWC Best Practices。每个验证器→score_issues→产生 readiness score（0-100）+ quality grade。
| 评分规则 | 扣分 | 最终分 |
|---|---|---|
| 1 error | -20 | 80 |
| 1 warning | -4 | 96 |
| 1 note | ~0 | 100 |
| 验证器权重 | 权重 | 验证器 |
|---|---|---|
| Blocker | 50 | Security (guide_lws_security) |
| Critical | 30 | Code Analyzer (run_code_analyzer) |
| Important | 20 | Accessibility + Best Practices + Data |
| 质量等级 | 分数 | 含义 |
|---|---|---|
| review-for-production | ≥90 | 可进行人工审查 |
| prototype | 60-89 | 功能可用但存在显著问题 |
| draft | <60 | 存在重大问题需处理 |
使用考量：AI 输出可能不准确——审查后再使用。工具可链式调用但不保证。可显式指定工具名："Use the guide_lwc_best_practices tool to review this component"。全面评估用 verify_aura_migration_completeness。
🎉 恭喜你完成了全部 31 章的 Lightning Web Components Developer Guide！感谢阅读。