1. Chat to MySQL 到底在解决什么问题Chat to MySQL 说白了就是让 AI 用自然语言直接查你的数据库。你问「上个月华东区付费用户有多少」AI 自己翻译成 SQL、连上 MySQL、把结果整理成人话返回。听起来很爽但真正落地时大部分人会卡在同一个地方AI 工具怎么安全、稳定地连到 MySQL。传统做法是把数据库账号密码硬编码进 AI 工具的配置里或者写个中间层 API 转发。前者权限收不住一个只读查询的工具拿到了写权限后者维护成本高每换一个 AI 客户端就要重写一遍适配。MCP Server 的出现正好补上了这块——它把「数据库访问」抽象成一个标准服务AI 工具通过 MCP 协议调用权限、连接、查询逻辑都收敛在 Server 侧。这篇面向的是需要让 AI 工具安全访问 MySQL 的开发者。我会交付一套可复制的 MCP Server 配置骨架包括settings.json和config.toml两种常见格式再配合 TaoToken 的统一 Key 和 API 通道完成接入最后给出连通性验证动作。整套流程走完你手里会有一个能跑通的 Chat to MySQL 闭环而不是一堆散落的配置片段。适合谁看正在用 Claude Desktop、Cursor、Cline 这类支持 MCP 的工具想让它们查 MySQL 的开发者或者你在自建 AI 助手需要一套标准化的数据库访问层。不需要你精通 MCP 协议细节但得能看懂 JSON 和 TOML会跑命令行。2. 前置准备TaoToken 统一 Key 与 MCP Server 选型在动手配 MCP Server 之前先把「AI 侧」的通道打通。这里用 TaoToken 做统一 Key 管理原因是它把模型调用和 API 通道收敛到一个入口你不用在每个 AI 工具里分别填不同的 Key换工具时只改一处。TaoToken 的定位是统一模型接入层官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。你需要先去控制台创建一个 API Key这个 Key 后面会填进 MCP Server 的配置里作为调用模型能力的凭证。MCP Server 这边MySQL 场景常用的方案是bytebase/dbhub它支持 stdio 和 SSE 两种传输方式能直接吃 MySQL 的 DSN 连接串。选它的理由是配置简单、依赖少npx就能拉起不用自己写 Server 代码。如果你更倾向容器化部署也可以用 1Panel 的 MCP 菜单创建本质是同一套东西包了个壳。资源清单先列一下免得配到一半发现缺东西资源用途获取方式MySQL 实例被查询的数据源已有库和表即可TaoToken API Key模型调用凭证控制台创建Node.js 18跑 dbhub官网下载或包管理器MCP 客户端Claude Desktop / Cursor 等按需安装注意MySQL 账号建议单独建一个只读账号给 MCP Server 用别直接上 root。权限最小化是这套方案能安全落地的前提。3. 可复制配置settings.json 与 config.toml 骨架配置分两块一块是 MCP Server 本身的启动参数一块是 AI 客户端里声明这个 Server 的配置。不同客户端用的格式不一样Claude Desktop 用settings.json一些命令行工具和 Cline 用config.toml我两种都给出来。3.1 MCP Server 启动参数dbhub 的核心启动命令是npx -y bytebase/dbhub关键参数是--transport和--dsn。DSN 格式是mysql://账号:密码IP:端口/库名。如果你走 SSE 传输还要指定端口。npx -y bytebase/dbhub \ --transport stdio \ --dsn mysql://readonly_user:your_password127.0.0.1:3306/edu_dbstdio 模式下Server 通过标准输入输出和客户端通信适合本地跑。SSE 模式会起一个 HTTP 服务适合远程或容器部署配置里要加--port。3.2 settings.json 配置骨架Claude Desktop 的配置文件在~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS或%APPDATA%\Claude\claude_desktop_config.jsonWindows。把 MCP Server 声明进去{ mcpServers: { mysql-edu: { command: npx, args: [ -y, bytebase/dbhub, --transport, stdio, --dsn, mysql://readonly_user:your_password127.0.0.1:3306/edu_db ], env: { TAOTOKEN_API_KEY: sk-your-taotoken-key, TAOTOKEN_BASE_URL: https://taotoken.net/api } } } }这里env里塞了 TaoToken 的 Key 和 Base URL。如果你的 MCP Server 本身不调模型这两个环境变量可以不放但如果你用的是带 AI 推理的 MCP 工具链它们就是模型调用的入口。3.3 config.toml 配置骨架Cline 或一些 CLI 工具用 TOML 格式结构类似但语法不同[mcp_servers.mysql-edu] command npx args [ -y, bytebase/dbhub, --transport, stdio, --dsn, mysql://readonly_user:your_password127.0.0.1:3306/edu_db ] [mcp_servers.mysql-edu.env] TAOTOKEN_API_KEY sk-your-taotoken-key TAOTOKEN_BASE_URL https://taotoken.net/api如果你走 SSE 模式把--transport stdio换成--transport sse --port 8080客户端侧则用 URL 方式声明{ mcpServers: { mysql-edu: { url: http://127.0.0.1:8080/sse, transport: sse, timeout: 180 } } }提示SSE 模式下timeout建议给到 180 秒以上复杂查询和模型推理叠加时容易超时。4. 验证请求从连通性到真实查询配置写完不代表能用得一步步验证。我按「先通链路、再查数据、最后走 AI」的顺序来。4.1 验证 MCP Server 能起来先单独跑 Server确认 DSN 没问题npx -y bytebase/dbhub --transport stdio --dsn mysql://readonly_user:your_password127.0.0.1:3306/edu_db如果终端没有报连接错误说明 DSN 和网络都通。报ECONNREFUSED就是 IP 端口不对报Access denied就是账号密码或权限问题。4.2 验证 TaoToken 通道用 curl 打一下 TaoToken 的 API确认 Key 有效curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-your-taotoken-key \ -H Content-Type: application/json \ -d { model: claude-3-5-sonnet, messages: [{role: user, content: ping}] }返回里有choices字段就说明通道正常。这一步能帮你把「模型侧」和「数据库侧」的问题分开定位不然出错时你不知道是 Key 的问题还是 MySQL 的问题。4.3 在客户端里发起真实查询重启 Claude Desktop 或 Cursor让配置生效。然后在对话里问一个具体问题比如「edu_db 库里 users 表有多少行」。AI 会调用 MCP Server 的查询工具返回结果。如果 AI 说「我没有数据库访问工具」说明 MCP Server 没被客户端识别检查配置文件路径和 JSON 语法。如果 AI 调了工具但返回空检查表名和库名是否写对。4.4 验证结果对照拿一个你已知答案的查询做对照。比如你手动SELECT COUNT(*) FROM users得到 1200那 AI 返回 1200 就说明整条链路正确。这一步别省它是你后面排查问题的基准线。5. 本篇常见错排查配这套东西踩坑是常态我把高频错误列出来你对号入座。MCP Server 启动即退出多半是npx没装或 Node 版本太低。跑node -v确认 18 以上npx -v确认能执行。如果公司网络限制 npm 源换源或提前npm install -g bytebase/dbhub。DSN 里的特殊字符没转义密码里有、:、/这些字符时DSN 会解析错。用 URL 编码处理比如写成%40。这个坑很隐蔽报错信息往往只说你连接失败。客户端读不到配置Claude Desktop 改完配置必须完全退出再启动不是关窗口。macOS 上CmdQ退出Windows 上任务栏右键退出。改完不重启等于没改。SSE 模式连不上检查端口是否被占用lsof -i :8080看一下。另外 SSE 的 URL 路径要对dbhub 默认是/sse有些版本是/mcp以启动日志打印的为准。TaoToken 返回 401Key 填错或过期。去控制台重新生成一个注意别把sk-前缀漏了。Base URL 也要确认是https://taotoken.net/api别多加斜杠。查询超时大表全扫描会卡住。给 MCP Server 配的 MySQL 账号加查询超时限制或者在 AI 提示词里约束「只查聚合结果不拉明细」。权限报错但账号看着没问题MySQL 的权限是分库分表的GRANT SELECT ON edu_db.* TO readonly_user%这种要确认 host 匹配。本地连用localhost远程连用%或具体 IP。6. 把通道固定下来后续换工具只改一处整套流程走完你手里应该有一个能跑的 Chat to MySQL 环境。回头看真正花时间的不是写配置而是排查「到底是哪一层断了」。我的建议是把 TaoToken 的 Key 和 Base URL 当成唯一变量MCP Server 的 DSN 当成另一个变量两者分开验证。这样下次换 AI 客户端时你只需要改客户端的 MCP 声明数据库和模型通道都不用动。如果你还在选模型或调 API 通道可以去模型对话页面直接试要长期跑编码和 Agent 任务Coding Plan 更划算接入过程中卡在 Key 或权限上API Keys 页面和接入文档能直接对照。通道固定下来之后Chat to MySQL 这件事就从「每次重新配」变成了「配一次一直用」。