简介
把 Claude Code 接到 MySQL:默认只读防护 + 可选 SSH 隧道自动管理,让查询可审计、可复现。
最适合: 让 Agent 参与查库/排障/验结构,但你希望它默认没有写权限的场景
适配: Claude Code(或任意 MCP 客户端);MySQL;可选 SSH 隧道连接远程数据库
配置时间: 5–10 分钟
关键事实(已验证)
- README 给出 Claude Code 配置示例:通过
ALLOW_*_OPERATION=false开关实现默认只读。 - README 提到支持 SSH 隧道与自动 start/stop hook(隧道生命周期管理)。
- README 的 Claude Code 入口是
npx @benborla29/mcp-server-mysql(stdio)。 - GitHub:1,638 stars · 206 forks;最近更新 2026-03-10(GitHub API 验证)。
正文
更安全的“Agent 查库”模式建议:
- MCP server 保持 只读:
ALLOW_INSERT_OPERATION/ALLOW_UPDATE_OPERATION/ALLOW_DELETE_OPERATION全部保持false。 - 让 Agent 先说清楚意图再执行(例如“我将执行
SELECT ... LIMIT 50来验证假设 X”)。 - 先做 结构探索(表/字段/索引),再做更重的查询。
- 远程数据库场景,优先走 README 的 SSH 隧道能力,并避免把凭证写进仓库(用 env prompt / 本地密钥管理)。
需要写入(迁移/回填)时,尽量只在短时窗口打开写权限,并保持人工审核。
FAQ
默认是只读吗?
答:是的。README 的配置示例用 ALLOW_*_OPERATION 环境变量开关来控制写操作,默认可保持关闭。
能连远程数据库吗? 答:可以。README 强调支持 SSH 隧道连接远程 MySQL。
如何在 Claude Code 里验证?
答:先用 claude mcp list 看 server 状态,再从小查询(如列出表)开始逐步确认。