CodeBuddy 中使用 MCP 连接 MySQL 数据库 — 完整指南一、什么是 MySQL MCPMCPModel Context Protocol是一种开放协议让 AI 助手如 CodeBuddy通过标准化接口连接外部数据源。MySQL MCP Server是一个独立的服务进程它把 MySQL 数据库能力列出表、执行查询等封装成标准的 MCP 工具CodeBuddy 作为 MCP Client 连接后即可让 AI 直接读写你的数据库。常见可用的 MySQL MCP Server 实现anthropic/mcp-server-mysql官方 Node 版常用mysql-mcp-server社区版注博客https://blog.csdn.net/badao_liumang_qizhi二、环境要求组件说明Docker 或 Node.js 18运行 MySQL MCP ServerMySQL 数据库目标库如spring_ai_copilot地址127.0.0.1:3306CodeBuddy已支持 MCP 配置的版本设置 → MCP 服务器三、在 CodeBuddy 中配置 MySQL MCP方式一通过 UI 添加推荐路径CodeBuddy 设置 →MCP 服务器→添加服务器填写字段字段值名称mysql-server描述MySQL 数据库连接可选类型LOCAL本地 STDIO 方式启动子进程状态ENABLED启用配置 JSON见下方配置 JSON本地命令方式{command:npx,args:[-y,anthropic/mcp-server-mysql,--host,127.0.0.1,--port,3306,--user,root,--password,123456,--database,spring_ai_copilot],env:{MYSQL_HOST:127.0.0.1,MYSQL_PORT:3306,MYSQL_USER:root,MYSQL_PASS:123456,MYSQL_DB:spring_ai_copilot}}如果 npx.cmd 路径不对不确定路径的话打开 PowerShell 执行where.exe npx用输出的全路径替换 command 的值即可。如果配置之后提示MCP error -32000: Connection closednpm error 404 Not Found - GET https://registry.npmjs.org/anthropic%2fmcp-server-mysql - Not foundnpm error 404npm error 404 ‘anthropic/mcp-server-mysql*’ is not in this registry.npm error 404npm error 404 Note that you can also install from anpm error 404 tarball, folder, http url, or git url.npm error A complete log of this run can be found in: C:\Users\admin\AppData\Local\npm-原因是anthropic/mcp-server-mysql 这个包已经不存在于 npm 仓库了可能已改名或下架。替代方案使用 wenit/mysql-mcp-serverNode.js与 npx 方式最接近把 args 中的包名替换即可{ mcpServers: { mysql-server: { type: stdio, command: D:/SoftWare/node22/npx.cmd, args: [-y, wenit/mysql-mcp-server], env: { MYSQL_HOST: 127.0.0.1, MYSQL_PORT: 3306, MYSQL_USER: root, MYSQL_PASSWORD: 123456, MYSQL_DATABASE: spring_ai_copilot }, description: MySQL 数据库查询服务 } } }方式二远程REMOTESSE 方式如果你已单独部署了一个 MySQL MCP HTTP 服务可改用远程配置{baseUrl:http://localhost:8081/mcp}类型选择REMOTE其余字段留空。四、配置参数说明参数含义示例command启动 MCP Server 的命令npxargs命令参数注意-y表示自动安装包[-y, anthropic/mcp-server-mysql, ...]--host/--portMySQL 主机与端口127.0.0.1/3306--user/--password数据库账号密码root/123456--database默认连接的数据库名spring_ai_copilotenv环境变量部分 Server 用环境变量读连接信息见上方 JSONbaseUrl远程模式下的 MCP 服务地址SSE/HTTPhttp://host:port/mcp五、使用流程用户视角1. 在 CodeBuddy 设置中添加 MySQL MCP Server 配置 2. 在工具列表点击「测试」验证连接 3. 确认状态为「启用 (ENABLED)」 4. 回到对话直接向 AI 提问数据库相关的问题 5. AI 自动选择并调用 MySQL MCP 工具返回结果AI 会根据你的自然语言意图自动决定调用哪个工具例如“列出所有表” → 调用列出表工具“查看 xxx 表结构” → 调用查询工具执行DESCRIBE“统计每个厂家的模型数” → 调用查询工具执行SELECT ... GROUP BY六、UI 操作要点操作位置说明添加服务器MCP 服务器 → 添加服务器填名称/类型/状态/配置 JSON测试连接工具列表右侧「试管」图标返回「连接成功发现 X 个工具」即正常启用/禁用列表「暂停/播放」图标禁用后 AI 不再调用该工具编辑/删除列表「编辑/删除」图标修改配置后重新测试查看详情列表「眼睛」图标查看配置 JSON 与已发现工具七、问题排查现象可能原因解决办法找不到npx命令未安装 Node.js 或不在 PATH安装 Node.js 18 并确认npx -v可用ECONNREFUSED 127.0.0.1:3306MySQL 未启动或端口不通确认 MySQL 服务已启动netstat -ano | findstr :3306检查Access denied for user账号/密码错误或无权限核对--user/--password确保允许连接Unknown database数据库不存在先CREATE DATABASE spring_ai_copilot;连接超时Server 启动慢或命令错误检查args拼写本地首次npx安装包需等待测试失败但 MySQL 正常配置 JSON 语法错误在 JSON 编辑器确认格式合法无多余逗号/引号工具列表为空数据库未注册或状态为禁用确认工具状态为ENABLED且测试通过命令行验证 MCP Server 本身npx-yanthropic/mcp-server-mysql\--host127.0.0.1--port3306\--userroot--password123456\--databasespring_ai_copilot能正常启动并打印工具列表说明 Server 侧没问题再回到 CodeBuddy 排查配置。数据库侧连通性自查SELECT1;SHOWDATABASES;八、使用示例配置并启用后直接在对话中提问即可你的提问效果使用 MySQL MCP 连接我的数据库列出所有表返回数据库全部表清单查看 model_llm 表的结构返回字段、类型、约束统计每个模型厂家的模型数量执行分组聚合查询并返回结果查一下 mcp_tool_info 表前 5 条记录返回前 5 行数据九、小结MySQL MCP 把数据库操作封装成 AI 可调用的工具配置一次即可反复使用。核心就是一份配置 JSON写好启动命令 MySQL 连接参数类型选LOCAL状态设ENABLED。配好后用「测试连接」验证再回到对话用自然语言提问即可。排查优先顺序MySQL 本身可连 → MCP Server 命令可启动 → CodeBuddy 配置 JSON 合法 → 工具状态为启用。