0 基础上手 mcp-server-mysql 让 Claude Code 直接操作 MySQL 数据库

日常开发中，Claude Code 等 AI 助手大多只能编写代码，无法直接连接数据库查询数据，大大限制了开发效率。今天给大家推荐实用桥梁工具 mcp-server-mysql，它能让 Claude Code 与 MySQL 直接通信，实现一键查库、看表结构等操作。本文从 0 到 1 手把手教你安装、配置与使用，轻松解锁 AI 数据库能力。

前期准备

1. MySQL 数据库
2. 已安装的 Claude Code

开始安装

第一步：安装 mcp-server-mysql

打开终端，输入：

npm install -g @benborla29/mcp-server-mysql

2 种配置方法

方法一：命令行

一行命令搞定，复制粘贴就行：

claude mcp add mysql-local \
  -e MYSQL_HOST="127.0.0.1" \
  -e MYSQL_PORT="3306" \
  -e MYSQL_USER="root" \
  -e MYSQL_PASS="你的密码" \
  -e MYSQL_DB="你的数据库" \
  -- npx @benborla29/mcp-server-mysql

注意： 把”你的密码”和”你的数据库”换成你自己的！

方法二：改配置文件

找到这个文件：~/.claude.json（在你的用户目录下）

打开它，加上这段：

{
  "mcpServers": {
    "mysql-test": {
      "command": "npx",
      "args": ["@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "你的用户名",
        "MYSQL_PASS": "你的密码",
        "MYSQL_DB": "你的数据库"
      }
    }
  }
}

参数解释：

• MYSQL_HOST：数据库地址；
• MYSQL_USER：数据库名称；
• MYSQL_PASS：数据库密码；
• MYSQL_DB：数据库名。

配置完成后如何使用？

1. 重启 Claude Code

2. 输入命令确认mcp-server-mysql是否安装成功：

claude mcp list

当看到 connected 就是上岗成功了

实战演示

场景一：查数据

你: 查一下产品线二级申请单表的前 10 条数据
Claude: [掏出小本本，连线数据库...]
┌─────┬──────────┬─────────────────────────────┬─────────┐
│ ID  │ 申请单号 │         申请标题            │ 状态    │
├─────┼──────────┼─────────────────────────────┼─────────┤
│ 1   │ EJ202... │ 产品线二级申请 _ 检测产品线    │ APPROV..│
│ 2   │ EJ202... │ 产品线二级申请 _IBG 产品线     │ APPROV..│
...

场景二：问表结构

你: orders 表有哪些字段？
Claude: orders 表有这些字段：
- id (主键)
- user_id (用户 ID)
- amount (金额)
- created_at (创建时间)
...

进阶：连多个数据库

如果你有好几个数据库（比如测试库、生产库）

配置多个 mcp-server-mysql

{
  "mcpServers": {
    "mysql-test": {
      "command": "npx",
      "args": ["@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_DB": "test_db",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "test 密码"
      }
    },
    "mysql-uat": {
      "command": "npx",
      "args": ["@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "192.168.1.100",
        "MYSQL_DB": "uat_db",
        "MYSQL_USER": "admin",
        "MYSQL_PASS": "uat 密码"
      }
    }
  }
}

如何指定用哪个数据库？

按上面配置完成后，怎么指定用哪个库呢？上命令：

你: 用 mysql-test 查一下用户表

Claude: [切换到测试库，开始查询...]

你: 在 mysql-uat 里看看今天的订单

Claude: [切换到 UAT 库，开始查询...]

安全小贴士

默认是”只读模式”

新装的媒婆默认只能”看”，不能”改”。

这是为了防止手滑删库跑路

想要写数据怎么办？

加上这些”通行证”：

{
  "env": {
    ...
    "ALLOW_INSERT_OPERATION": "true",   // 允许插入
    "ALLOW_UPDATE_OPERATION": "true",   // 允许更新
    "ALLOW_DELETE_OPERATION": "true"    // 允许删除（慎用！）
  }
}

警告： 开了 DELETE 用之前想清楚！

远程数据库怎么连？

数据库在远方服务器？用 SSH 隧道当”传送门”：

{
  "env": {
    "MYSQL_HOST": "127.0.0.1",
    "MYSQL_USER": "db_user",
    "MYSQL_PASS": "db 密码",
    "MYSQL_DB": "remote_db",
    "SSH_HOST": "跳板机地址",
    "SSH_USER": "ssh 用户",
    "SSH_PASS": "ssh 密码"
  }
}

常见问题（踩坑指南）

连不上数据库？

检查清单：

1. 数据库开机了吗？ 🖥️
2. 用户名密码对吗？ 🔐
3. 数据库名字拼写对吗？ ✍️
4. 网络通吗？ 🌐
5. 防火墙拦着吗？ 🔥

写数据报错？

检查有没有加 ALLOW_xxx_OPERATION="true"。

工具找不到？

运行 claude mcp list 看看安装成功没。

配置改了不生效？

重启 Claude Code！就像手机装新 App 要重启一样。

总结

mcp-server-mysql 作为 AI 助手与数据库的桥梁，简单配置即可让 Claude Code 具备完整 MySQL 操作能力，支持多库切换、SSH 远程连接，默认只读更安全。按照安装、配置、验证、实战的流程操作，就能让 AI 助手真正帮你处理数据库工作，大幅提升前后端开发效率。

以上关于0 基础上手 mcp-server-mysql 让 Claude Code 直接操作 MySQL 数据库的文章就介绍到这了，更多相关内容请搜索码云笔记以前的文章或继续浏览下面的相关文章，希望大家以后多多支持码云笔记。