夜雨聆风
接口文档总在变?Cursor 里 3 个 MCP,让用例和脚本自动跟上
在 Cursor 里做接口自动化、数据库校验和 UI 自动化，光靠「口述需求」不够稳——把接口定义、表结构、页面流程交给 MCP 读进来，再配合 Skill 约束输出格式，AI 才能按你的规范生成可落地的用例和脚本。这篇介绍我常用的三个 MCP：Apifox、MySQL、Playwright，以及怎么配、分别能干什么。
01 配置入口：从哪里添加 MCP
Cursor 的 MCP（Model Context Protocol）在设置 → Tools & MCP里配置。
步骤
① 点击 Cursor 右上角齿轮图标进入设置。
② 左侧找到并点击 「Tools & MCP」。
③ 右侧「Installed MCP Servers」下若显示「No MCP Tools」，点击 「Add Custom MCP」 添加；也可以直接在项目根目录的 .cursor/mcp.json 里写配置，实现项目级 MCP。
02 三个 MCP 分别做什么
1. Apifox MCP：接口自动化用例的「单一数据源」
作用：让 Cursor 直接读取 Apifox 里的接口定义（路径、方法、请求/响应参数、示例等），不再靠你复制粘贴或口述。在 Skill 里定义好「接口自动化用例模板」（如请求构造、参数化、断言方式、目录与命名），AI 就能按接口结构 + 模板自动生成接口自动化 Case，和文档、现网保持一致。
典型用法：在对话里 @ Apifox MCP，选中某个接口或项目，让 AI 根据该接口的详细结构，按 Skill 中的方法模板生成单接口的自动化用例（正常/异常/边界），可直接进仓维护。
2. MySQL MCP：表结构 + 业务知识 → 测试用例与数据库校验
作用：读取数据库的表结构、字段、约束等信息。在 Skill 里补充表相关的业务知识：每张表的业务含义、关键字段的业务背景、表与表之间的关联（如订单表与用户表、流水表的关系），AI 就能结合「库表真相」和「业务真相」生成更贴业务的测试用例，以及自动化数据库校验脚本（造数、清理、断言查表结果）。
典型用法：@ MySQL MCP 拉取库表结构，在 Skill 中描述业务规则与表间关系，让 AI 生成数据准备步骤、断言 SQL 或结果比对逻辑，用于接口/场景自动化里的数据校验。
3. Playwright MCP：UI 自动化脚本的创建与优化
作用：对接 Playwright 能力，在 Cursor 里做浏览器自动化。你可以描述业务流程（如登录 → 下单 → 支付），AI 结合 Playwright MCP 生成或优化流程化 UI 自动化 Case，包括定位元素、操作步骤、等待与断言，便于做 E2E 或关键路径的 UI 回归。
典型用法：说明要覆盖的页面和操作顺序，让 AI 生成 Playwright 脚本；或把现有脚本贴进去，让 AI 按统一风格做重构、补断言、加等待，形成可维护的 UI 自动化用例集。
一句话记Apifox MCP 读接口 → 按 Skill 模板生成接口自动化用例；MySQL MCP 读表结构 + Skill 写业务知识 → 生成测试用例与数据库校验；Playwright MCP → 生成与优化流程化 UI 自动化脚本。
03 mcp.json 长什么样（示例）
项目级配置放在 .cursor/mcp.json，根键为 mcpServers，每个 MCP 一项。下图是示例结构（敏感信息已打码）：
配图（图2）：mcp.json 示例，包含 playwright、API 文档（Apifox）、mysql-schema 三个 MCP 的 command、args、env 配置。
要点简述
Playwright：一般用 npx @playwright/mcp@latest 即可，无需额外环境变量。
Apifox（图中为「API 文档」）：通过 npx 启动，args 里会带项目相关参数；需要在 env 里配置 APIFOX_ACCESS_TOKEN 做鉴权，具体参数以官方文档为准。
MySQL（图中为 mysql-schema）：通过 npx 启动 mcp-mysql-schema，在 env 里配置 MYSQL_INSTANCES，用 JSON 串写明 instanceId、host、port、user、password 等，可配置多实例。
配置好后重启或重载 Cursor，在对话里即可 @ 对应 MCP 使用。
04 和 Skill 怎么配合
MCP 只负责「把真实数据拉进对话」；用例长什么样、脚本用什么框架、断言怎么写，要靠 Skill 约定。
建议在 Skill 里分别写清：
· 接口自动化：技术栈（如 pytest + requests）、目录结构、单接口用例模板（入参、断言、命名）；注明「以 Apifox MCP 读到的接口为准」。
· 数据库与业务：表业务说明、字段含义、表间关系；约定造数/清理/校验的写法，注明「以 MySQL MCP 读到的表结构为准」。
· UI 自动化：Playwright 项目结构、选择器约定、等待与断言规范，便于 AI 生成或优化流程化 Case。
核心一句MCP 负责「数据从哪来」，Skill 负责「产出长什么样」——两者一起用，才能在 Cursor 里稳定产出可维护的接口用例、数据库校验和 UI 自动化脚本。
05 小结
· 配置：设置 → Tools & MCP → Add Custom MCP，或编辑项目 .cursor/mcp.json。
· Apifox MCP：读接口结构，按 Skill 中的接口方法模板自动生成接口自动化用例。
· MySQL MCP：读库表结构，配合 Skill 中的表业务知识、表间关系，生成详细测试用例与自动化数据库校验。
· Playwright MCP：用于 UI 自动化脚本的创建与优化，生成流程化 UI 自动化 Case。
如果你已经在用 Cursor 做测试或自动化，不妨先配好这三个 MCP，再在 Skill 里把「用例与脚本规范」写死，剩下的交给 AI 生成、你来审阅和迭代。
