CodeBuddy 中使用 MCP 连接 MySQL 数据库完整指南_Mysql

一、什么是 mysql mcp

mcp（model context protocol） 是一种开放协议，让 ai 助手（如 codebuddy）通过标准化接口连接外部数据源。

mysql mcp server 是一个独立的服务进程，它把 mysql 数据库能力（列出表、执行查询等）封装成标准的 mcp 工具，codebuddy 作为 mcp client 连接后即可让 ai 直接读写你的数据库。

常见可用的 mysql mcp server 实现：

@anthropic/mcp-server-mysql（官方 node 版，常用）
mysql-mcp-server（社区版）

二、环境要求

组件	说明
docker 或 node.js 18+	运行 mysql mcp server
mysql 数据库	目标库（如 `spring_ai_copilot`，地址 `127.0.0.1:3306`）
codebuddy	已支持 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 closed

npm error 404 not found - get https://registry.npmjs.org/@anthropic%2fmcp-server-mysql - not found
npm error 404
npm error 404 ‘@anthropic/mcp-server-mysql@*’ is not in this registry.
npm error 404
npm error 404 note that you can also install from a
npm 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-server（node.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 数据库查询服务"
    }
  }
}

方式二：远程（remote）sse 方式

如果你已单独部署了一个 mysql mcp http 服务，可改用远程配置：

{
  "baseurl": "http://localhost:8081/mcp"
}

类型选择 remote，其余字段留空。

四、配置参数说明

参数	含义	示例
`command`	启动 mcp server 的命令	`npx`
`args`	命令参数（注意 `-y` 表示自动安装包）	`["-y", "@anthropic/mcp-server-mysql", ...]`
`--host` / `--port`	mysql 主机与端口	`127.0.0.1` / `3306`
`--user` / `--password`	数据库账号密码	`root` / `123456`
`--database`	默认连接的数据库名	`spring_ai_copilot`
`env`	环境变量（部分 server 用环境变量读连接信息）	见上方 json
`baseurl`	远程模式下的 mcp 服务地址（sse/http）	`http://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:3306`	mysql 未启动或端口不通	确认 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 -y @anthropic/mcp-server-mysql \
  --host 127.0.0.1 --port 3306 \
  --user root --password 123456 \
  --database spring_ai_copilot

能正常启动并打印工具列表，说明 server 侧没问题，再回到 codebuddy 排查配置。

数据库侧连通性自查：

select 1;
show databases;

八、使用示例

配置并启用后，直接在对话中提问即可：

你的提问	效果
`使用 mysql mcp 连接我的数据库，列出所有表`	返回数据库全部表清单
`查看 model_llm 表的结构`	返回字段、类型、约束
`统计每个模型厂家的模型数量`	执行分组聚合查询并返回结果
`查一下 mcp_tool_info 表前 5 条记录`	返回前 5 行数据