L3 — MCP（模型上下文协议）
赋予 AI "手"和"眼"，从"说"到"做"的关键跃迁。L2 Skill 描述"做什么"，L3 MCP 让 AI 真正"执行操作"。
能力概览
MCP 层是体系的执行层——AI 通过 MCP Tools 主动发起操作，从「说」到「动手」的关键跳跃。
MCP Server 能力
│
├── 1. 网络 I/O
│ ├── HTTP / REST 调用
│ ├── GraphQL 查询
│ ├── WebSocket 实时连接
│ ├── 在线文档抓取 & 结构化解析
│ └── 业务接口代理、鉴权请求调试
│
├── 2. 本地文件系统
│ ├── 多格式文件读写（TS / JSON / Vue / YAML 等）
│ ├── 代码 / 配置文件生成与更新
│ ├── 目录扫描、项目结构分析
│ └── 文件监听、变更自动化触发
│
├── 3. 脚本 / 进程 & 系统命令
│ ├── 自定义脚本执行
│ ├── 构建、编译、测试、格式化指令
│ ├── 进程启停、端口占用管理
│ └── 原生 Shell / 系统命令调用
│
├── 4. Git 全链路操作
│ ├── 状态、差异、变更内容读取
│ ├── 提交日志、分支、标签信息查询
│ └── 辅助生成规范 Commit 信息
│
├── 5. 代码 AST 结构化解析
│ ├── TS 类型、接口、函数签名提取
│ ├── Vue SFC 组件结构解析（props / emits / setup）
│ ├── 依赖图谱分析、导入导出解析
│ └── 代码片段抄取、规范问题扫描
│
├── 6. 数据库 & 轻量存储
│ ├── SQLite 本地数据查询
│ ├── Redis 缓存与共享状态管理
│ └── JSON 本地 KV 轻量化存储
│
├── 7. 包管理 & 工程运维
│ ├── NPM 包版本查询、依赖版本检测
│ ├── 依赖过期扫描、版本升级辅助
│ └── 工程打包、发布流程联动
│
├── 8. 系统 & 基础设施能力
│ ├── 系统信息、环境变量读写
│ ├── Docker 容器、本地服务管理
│ └── 端口检测、本地服务运维
│
├── 9. 通用工具能力
│ ├── 加解密、编解码、数据校验
│ └── 配置文件格式化、语法校验
│
└── 10. AI 元能力增强
├── 本地向量检索、语义知识库查询
└── 三方 AI 能力联动（审代码、翻译、总结）核心特征：细粒度、有副作用、AI 自由编排。每个 Tool 只做一件事，AI 根据 Skill 描述自行决定调用顺序和参数。
什么是 MCP？
MCP（Model Context Protocol）是 AI 调用外部工具的标准协议。通过 MCP，AI 可以：
- 调用后端接口（查询 / 新增 / 更新）
- 读写本地文件
- 执行任意有副作用的操作
在 wl-skills-kit 中：MCP Server（mcp/ 目录）注册了一系列工具，AI 在执行 Skill 时直接调用这些工具，无需人工复制粘贴接口结果。
kit 实现了哪些 Tool？
29 个 Tool，六大类（完整清单与参数见 PC Skills — MCP 权威清单）：
| 类别 | 数量 | 干什么 |
|---|---|---|
| 菜单 / 字典 / 权限 | 13 | 基线查询与确定性同步，替代手工点后台 |
| 项目感知 | 7 | 页面扫描、路由检查、页面校验、UI 体检、快照 Blueprint |
| 模板治理 | 5 | 模板检索 / 提取 / 校验 / 审计 / 差异（confirmWrite 门禁） |
| 环境标准化 | 3 | scan → apply（受控）→ verify |
| 通知 | 1 | 审计报告推送飞书 webhook（可选） |
效果量化：菜单同步 token 节省约 87%，从 20 分钟 10 次手动操作 → 1 分钟 0 次手动操作。权限同步原本需切换 3 个后台界面 ≥ 15 分钟，现在 1 分钟 0 次手动操作。
MCP 三原语说明
Tools（当前在用）
AI 主动调用，有副作用（读写/调接口）。所有主流编辑器均支持。这是当前项目的核心用法。
Resources（未启用）
应用层暴露只读数据源，AI 订阅变更。适合内部 Swagger/OpenAPI 动态接口场景。当前静态文档用文件直接引用即可，引入 Resources 是过度设计。
Prompts（了解即可）
在 MCP server 里注册"预制 slash command 模板"。编辑器支持情况：Claude Code ✅；Cursor ⚠️ 部分；VS Code Copilot / Windsurf / Cline ❌ 未支持。团队主力是 VS Code Copilot，故暂不实现。
场景实践：新页面上线要挂"三处后台"
场景：page-codegen 产出了客户档案页面，上线前要挂菜单、字典、权限三处后台——过去这是最容易漏、最繁琐的一步。
没有 MCP 时：切 3 个后台界面人工点（菜单管理建目录/菜单 → 字典管理录枚举 → 权限管理配角色+动作），≥ 15 分钟，漏一处就是联调事故。
有 MCP 后：对 AI 说"同步菜单/字典/权限" → menu-sync 自动 wls_menu_query 查现有菜单树 → 与 page-spec 对比 → wls_menu_upsert 补差异 → permission-sync 完成角色 + 授权 + 动作闭环。
| 步骤 | 过去（手工） | 现在（MCP 驱动） |
|---|---|---|
| 菜单 | 10 次手动操作 / 20 分钟 | 1 分钟 / 0 次手动 |
| 权限 | 切 3 个界面 ≥ 15 分钟 | 1 分钟 / 0 次手动 |
| Token | — | 节省约 87% |
写操作全部经过 _mcp-guardrail.md 护栏（先查后写、幂等去重），不是裸调接口。
MCP 项目级配置（init 自动生成）
| 编辑器 | 配置文件路径 |
|---|---|
| Cursor | .cursor/mcp.json |
| Claude Code | .mcp.json |
| VS Code / GitHub Copilot | .vscode/mcp.json |
| Kiro | .kiro/settings/mcp.json |
| Windsurf / Cline / Trae / Qoder | 手动配置（参考 .github/guides/mcp-setup.md） |
延伸阅读
- permission-sync Skill 文档 — MCP 驱动的权限闭环
- L4 — CLI — MCP 与 CLI 的协作关系
- AI 最佳实践总览
参考资料
| 资源 | 说明 |
|---|---|
| Model Context Protocol 官网 | MCP 协议完整规范，L3 的底层标准 |
| MCP 规范 GitHub | MCP 协议源码与最新动态 |
| MCP Servers 社区目录 | 社区贡献的各类 MCP Server，可直接复用 |
| GitHub Copilot MCP 文档 | Copilot 中配置 MCP 的官方指南 |
| Cursor MCP 配置文档 | Cursor 中配置 MCP Server |