mysql-mcp

使用 mcp-server-mysql 查询与操作 MySQL

前置检查

本 skill 只适用于已连接 mcp-server-mysql 的会话。动手前先确认当前工具列表里确实存在 list_profile 和 mysql_query 等工具（客户端里通常带 mcp__<server名>__ 前缀，按后缀识别）。工具不存在时按常规方式完成数据库任务，或引导用户按仓库 README 配置连接。

这个 MCP server 是安全优先设计：每条 SQL 先过工业级 AST 解析校验（解析失败一律拒绝），读语句包在只读事务里执行，驱动层禁多语句。理解它的边界，你就能高效使用它；试图绕过只会浪费轮次。

心智模型

• 一次操作绑定一个 profile。profile 是服务端配置的独立连接，拥有自己的默认库、连接池、安全规则、审计及统计。所有 mysql_* 工具都必填 profile；list_profile 无参数，返回按名称排序的 {profiles: [{name, description}]}，只描述配置，不代表连接健康检查通过。
• 默认只读、白名单默认全拒。能执行什么语句类型（allowed_statements）、能碰哪些表（table_whitelist）由所选 profile 的服务端配置决定，会话内无法更改。
• DENIED 是边界，不是故障。收到 DENIED [规则名]: 原因 时，按下文对照表调整做法；同一条语句换个写法重试大概率还是拒（校验基于语义解析，注释、大小写、版本化注释 /*!...*/ 都藏不住东西）。
• fail-closed。极个别 MySQL 边缘语法解析器不认时也会被拒（parse_error），这时换等价写法，而不是反复重试原句。
• 需要放宽边界（加白名单、开写权限、调行数上限）时，如实告诉用户去改服务端 config.yaml 并重启 MCP，不要在 SQL 层想办法。

工具选择

硬规则（违反必被拒）

1. 一次一条语句。mysql_query / mysql_execute 只接受单语句；多条语句唯一的入口是 mysql_script。
2. 读写分道。写语句走 mysql_query 会被 wrong_tool 拒，反之亦然。选工具本身就是意图声明。
3. UPDATE / DELETE 必须带 WHERE（block_unfiltered_writes 默认开启）。这是防误操作护栏：若用户确实要全表操作，先向用户确认，再用能表达真实意图的条件（如主键范围）执行，不要默默加 WHERE 1=1 规避。
4. 脚本内禁 DDL。MySQL 的 DDL 会隐式提交事务，破坏"全成或全回滚"承诺，所以 mysql_script 无条件拒 DDL——即使服务端开了 ddl 权限。DDL 单独用 mysql_execute 执行。
5. 这些语句在任何工具里都不可用：SET、USE、GRANT、CALL、LOAD DATA、LOCK TABLES、BEGIN / COMMIT / ROLLBACK 等事务控制。跨库查询用 库名.表名 限定，不要 USE；需要事务用 mysql_script，不要手写 BEGIN/COMMIT。
6. SELECT ... INTO OUTFILE / LOAD_FILE() 被永久禁止，没有开关，不要尝试。
7. 只能访问白名单内的表。JOIN、子查询、CTE、INSERT ... SELECT 里涉及的每一张表都会被逐一校验，任何一张不在白名单整条拒。