1. 为什么我非要把 MySQL 接到 Cursor 里先说一个我自己的真实痛点。项目里有一张orders表字段有二十多个每次想确认「上周退款且未发货的订单有几条」我都得切到数据库客户端翻表结构、拼 SQL、跑一遍、再复制结果回聊天窗口问 AI 怎么解读。来回切窗口这件事一天能干几十次烦到爆炸。Cursor 的 Agent 模式本身已经能读写你工作区里的代码文件但它默认看不到你数据库里的真实数据。你问它「本地库里有多少条用户记录」它只能根据代码里的实体类猜猜出来的数字没有任何意义。这不是模型不行而是它缺少一条通往数据库的通道。MCPModel Context Protocol就是补上这条通道的东西。你可以把它理解成 AI 世界的 USB-C 接口模型本身不关心对面接的是 MySQL、文件系统还是地图服务只要对方按 MCP 协议暴露能力Agent 就能调用。落到我们这篇的场景就是让 Cursor 通过一个 MySQL MCP Server用自然语言完成建表、查询、改数据。适合谁看手上有本地或测试环境 MySQL、日常用 Cursor 写代码、想让 Agent 帮忙查数据但不想把库暴露到公网的人。整篇我会给你可直接复制的 MCP 配置骨架、TaoToken 统一 Key 的接入点、连接验证动作以及读写权限隔离的实操。踩过的坑我也会标出来尤其是「能查不能写」这类权限问题。2. 前置准备TaoToken 统一 Key 与 API 通道在配 MySQL MCP 之前先把模型通道理顺。原因很简单Cursor 的 Agent 要调用工具、要理解你的自然语言指令、要把 SQL 结果翻译成人话这些都消耗模型调用。如果你用的是零散申请的多个 Key或者通道不稳定Agent 会在「思考到一半」的时候断掉表现就是工具调用卡住、回复截断。我的做法是统一走 TaoToken 的 API 通道。它提供一个兼容常见接口规范的入口Cursor 里配置自定义模型时填一次就行不用为每个模型单独折腾。官网地址是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。具体操作分两步。第一步去控制台创建 API Key地址 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 创建后复制保存这个 Key 后面要填进 Cursor 的模型配置里。第二步如果你打算长期用 Agent 跑编码和数据库操作建议看一下 Coding Plan地址 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它更适合高频调用场景比按次零散调用省心。这里有个关键点要提醒MCP Server 本身不负责模型调用它只负责「把数据库能力暴露给 Agent」。模型调用走的是 Cursor 的模型配置也就是上面这个 TaoToken 通道。两者是分开的别混在一起排查问题。很多人配完 MCP 发现 Agent 不响应其实是模型通道没配好跟 MCP 一点关系没有。配置模型时在 Cursor 的 Settings 里找到 Models 区域添加自定义模型Base URL 填 https://taotoken.net/api API Key 填你刚创建的那串。填完点 Verify能通过就说明通道没问题。这一步过了再往下走能省掉后面一半的排障时间。3. 可复制的 MCP 配置骨架现在进入正题。Cursor 的 MCP 配置有两种放置位置全局配置和项目级配置。全局配置对所有项目生效路径在用户目录下的.cursor/mcp.json项目级配置放在项目根目录的.cursor/mcp.json只对当前项目生效。我建议数据库这种带环境差异的东西用项目级避免在 A 项目配的库在 B 项目里被误操作。先给你一份最小可用的 MySQL MCP 配置骨架直接复制改参数即可{ mcpServers: { mysql-local: { command: npx, args: [ -y, benborla29/mcp-server-mysql ], env: { MYSQL_HOST: 127.0.0.1, MYSQL_PORT: 3306, MYSQL_USER: mcp_reader, MYSQL_PASS: 你的只读账号密码, MYSQL_DB: your_database, ALLOW_INSERT_OPERATION: false, ALLOW_UPDATE_OPERATION: false, ALLOW_DELETE_OPERATION: false } } } }这份配置里几个参数值得单独说清楚。MYSQL_HOST填127.0.0.1而不是localhost是因为部分环境下localhost会走 socket 连接npx 启动的子进程可能找不到 socket 路径直接报连接失败。MYSQL_USER我特意用了mcp_reader这个只读账号而不是 root这是权限隔离的第一步后面会展开。三个ALLOW_*_OPERATION是写操作开关默认全关。这意味着 Agent 只能查不能改。等你确认查询链路稳定了再按需打开。我强烈建议先跑通只读再逐步放开别一上来就全开。如果你需要写权限把对应开关改成true即可但账号权限也要同步放开两者缺一不可。MCP Server 的开关是「允许 Agent 发起这类操作」数据库账号权限是「数据库是否接受这类操作」任何一层拦住都会失败。配置写完后回到 Cursor Settings 的 MCP 面板找到mysql-local这一项右侧应该显示绿灯。红灯的话先点刷新还不行就看下一节的排障。绿灯之后把 Agent 模式打开模型选你刚配好的 TaoToken 通道下的模型就可以开始用自然语言操作数据库了。4. 连接验证与自然语言操作实测配置绿灯只是「进程起来了」不代表「连上库了」。真正的验证要从一次实际查询开始。我在 Agent 对话框里输入的第一句是帮我查一下当前数据库里一共有多少张表分别叫什么名字。Agent 会自动调用 MCP 工具你会看到它先列出工具调用过程然后返回表清单。如果这一步返回了正确的表名说明连接、认证、库选择三件事都通了。如果返回空或者报错先别急着改配置往下看排障章节。连接确认后我按从易到难的顺序做了几组验证。第一组是纯查询确认读链路查一下 users 表里一共有多少条记录最近注册的 5 个用户是谁。Agent 会生成SELECT COUNT(*)和带ORDER BY created_at DESC LIMIT 5的语句执行后把结果整理成表格给你。这一步能过说明读权限和 SQL 生成都没问题。第二组是建表。这里要提前说一个坑很多 MySQL MCP Server 默认不开放 DDL 操作也就是建表、改表结构这类语句会被拦。我实测时让 Agent 建一张学生表它返回的是权限不足。这不是配置错了而是 Server 的安全设计。解决办法有两个一是临时用数据库客户端手动建表二是换一个支持 DDL 的 Server 或自己改源码放开。我选了前者因为建表这种低频操作没必要为它放开高危权限。手动建好表后第三组验证写操作。先把配置里的ALLOW_INSERT_OPERATION改成true同时确认mcp_reader账号有对应表的 INSERT 权限然后重启 MCP 服务。输入往 students 表里插入一条记录姓名张三年龄 16性别男。Agent 调用插入工具后返回成功。这时候别只信它的回复自己去数据库客户端SELECT一下确认数据真的落库了。我见过 Agent 报告成功但实际没写进去的情况通常是事务没提交或者权限被静默拒绝。第四组验证更新和多表联查。更新操作把ALLOW_UPDATE_OPERATION打开输入「把张三的年龄改成 18」。多表联查不需要额外开关建一张关联表后直接问查一下张三一共选了几门课总共多少课时。Agent 会自动写 JOIN 语句并汇总结果。到这一步建表、查询、改数据三条链路就都验证完了。整个过程你不需要手写一行 SQL但每一步的结果都要自己复核这是用 Agent 操作数据库的基本纪律。5. 本篇常见错误与排查配 MySQL MCP 踩坑的概率不低我把遇到过的几类整理出来对照着查能省很多时间。第一类是 MCP 面板一直红灯。最常见原因是 npx 拉包失败通常是网络或缓存问题。可以先在终端手动跑一次npx -y benborla29/mcp-server-mysql看能不能正常启动。如果终端能跑但 Cursor 里红灯多半是 Cursor 启动 MCP 子进程时的环境变量没继承检查env字段是否写全。第二类是连接被拒报ECONNREFUSED。先确认 MySQL 服务在跑MYSQL_HOST用127.0.0.1而不是localhost。如果 MySQL 配置了只监听 socket 不监听 TCP也会出现这个错需要在 MySQL 配置里确认bind-address和端口监听状态。第三类是认证失败报Access denied。检查账号密码是否正确以及这个账号是否允许从127.0.0.1连接。MySQL 的账号是带 host 的mcp_readerlocalhost和mcp_reader127.0.0.1是两个不同的账号授权时要写对。第四类是查询能跑但写操作失败。先看 MCP 配置里的ALLOW_*_OPERATION开关是否打开再看数据库账号有没有对应权限。两层都确认后还失败检查表是否有触发器或约束拦截。这类问题 Agent 的报错信息通常比较模糊建议直接去 MySQL 的错误日志里找。第五类是 Agent 不调用 MCP 工具只是用文字回答。这通常是模型通道的问题不是 MCP 的问题。回到 Cursor 的模型配置确认 TaoToken 通道验证通过并且当前 Agent 用的就是这个通道下的模型。模型不支持工具调用时也会出现只回文字不调工具的情况。第六类是结果对不上。Agent 说插入了但库里没有或者查询数字和客户端不一致。优先怀疑事务和缓存其次怀疑 Agent 连的库和你以为的不是同一个。MYSQL_DB填错库名是很隐蔽的坑因为连接照样成功只是操作了另一个库。6. 权限隔离与后续接入建议用嘴操作数据库很爽但爽的前提是别把生产库玩坏。我的做法是三层隔离。第一层MCP 只连测试库或本地库生产库的连接信息根本不写进配置文件。第二层日常查询用只读账号写操作临时开开关、临时提权用完就关。第三层高危操作比如DROP、TRUNCATE永远不通过 Agent 执行这类语句的破坏性不可逆不值得为省几秒去冒险。如果你要把这套东西接到团队里建议每个开发者用自己的只读账号而不是共用一个。这样出问题时能追溯到人权限回收也干净。写权限的开放要走审批别在配置文件里长期挂着true。模型通道这边日常查询用模型对话就够了地址 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 临时问几句数据很方便。如果你像我一样长期用 Agent 跑编码加数据库操作Coding Plan 更合适地址 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。Key 的管理统一在控制台地址 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 接入细节看文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite API Key 的创建入口在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果你用的是 Claude Code 这类工具Anthropic 兼容接入的说明在 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 。最后留一个我自己的习惯每次放开写权限前先在测试库跑一遍同样的操作确认 Agent 生成的语句符合预期再切到目标库。这个动作多花两分钟但能挡掉绝大多数误操作。数据库这东西谨慎永远不亏。
