Claude Code 接入 MySQL 实战:让 AI 看懂你的表结构和数据
背景
在使用Claude code 进行日常业务开发过程中,面临新的表结构和接口时,常常需要跟AI介绍表字段和接口以便它能顺利的开发接口、写Sql等,此等场景下,会造成很长的上下文,且比较麻烦,同时,针对一些表结构索引优化、Sql优化等工作,也需要和AI进行长篇大论的交流,比较繁琐。
解决方案:通过引入开源MySql mcp让大模型可以直接连接数据库进行读取,极大方便了开发者,在测试环境下,测试数据对安全性没太大要求,因此可以让大模型自己读数据库辅助开发和编码。
一、MCP Server for MySQL 安装
依赖:node.js、claude code cli
1.MySql MCP安装命令:
# Using npm npm install -g @benborla29/mcp-server-mysql # Using pnpm pnpm add -g @benborla29/mcp-server-mysql2.启动该mcp服务
npx @benborla29/mcp-server-mysql官网参考:https://github.com/benborla/mcp-server-mysql#installation
二、为Claude Code添加该MCP
安装成功后,添加mcp到claude code
# cc 添加 mcp 命令 # 在cc cli具体执行时,注意删除换行符,每个参数间只留空格即可,否则可能会被cli终端识别成多行命令 # 下列连接参数配置成需要连接的数据库 claude mcp add your_mcp_name \ -e MYSQL_HOST="127.0.0.1" \ -e MYSQL_PORT="3306" \ -e MYSQL_USER="root" \ -e MYSQL_PASS="your_password" \ -e MYSQL_DB="your_database" \ -e ALLOW_INSERT_OPERATION="false" \ -e ALLOW_UPDATE_OPERATION="false" \ -e ALLOW_DELETE_OPERATION="false" \ --scope project \ -- npx @benborla29/mcp-server-mysql # 删除换行符后执行,避免cli识别为多行命令 claude mcp add your_mcp_name -e MYSQL_HOST="127.0.0.1" -e MYSQL_PORT="3306" -e MYSQL_USER="root" -e MYSQL_PASS="your_password" -e MYSQL_DB="your_database" -e ALLOW_INSERT_OPERATION="false" -e ALLOW_UPDATE_OPERATION="false" -e ALLOW_DELETE_OPERATION="false" --scope project -- npx @benborla29/mcp-server-mysql 注意:这里cc最好是添加项目级的mcp,因为不同项目的数据库不一样,针对不同项目配置不同的mcp参数,因此没必要全局安装该mcp
执行成功后,会在项目根目录下生成名为.mcp.json的配置文件:

三、验证是否添加成功
# 方式一 claude mcp list #方式二,进入claude code会话后,执行命令 /mcp查看结果:

connected表示已经添加成功,且已经连接上了!
四、使用

至此,mysql mcp添加成功,并且可以访问配置的数据库,极大提升AI开发效率!
五、常见问题及处理方案
1、如果为cc添加mcp后,验证时发现该mcp的状态是 Failed to connect,可以去cc安装根目录同级目录下找到全局配置文件,名为.claude.json的配置文件,找到并查看你项目目录下的mcp配置是否正确:

配置检查完成并设置好后,重启cc即可解决!