MySQL MCP 安装配置完整指南
🎉 成功案例
版本: @benborla29/mcp-server-mysql@2.0.2
状态: ✅ 安装成功
环境: Windows + Trae.ai
📋 安装步骤
1. 安装稳定版本
npm install -g @benborla29/mcp-server-mysql@2.0.2
2. 验证安装
npm list -g @benborla29/mcp-server-mysql
应该显示：@benborla29/mcp-server-mysql@2.0.2
⚙️ 配置文件
基础配置（只读模式）
{"mcpServers": {"mysql": {"command": "npx","args": ["-y", "@benborla29/mcp-server-mysql@2.0.2"],"env": {"MYSQL_HOST": "localhost","MYSQL_PORT": "3306","MYSQL_USER": "root","MYSQL_PASS": "root","MYSQL_DB": "admin-demo"}}}
}
高级配置（支持DDL操作）
如果需要执行创建表、删除表等DDL操作，使用以下配置：
{"mcpServers": {"mysql": {"command": "npx","args": ["-y", "@benborla29/mcp-server-mysql@2.0.2"],"env": {"MYSQL_HOST": "localhost","MYSQL_PORT": "3306","MYSQL_USER": "root","MYSQL_PASS": "root","MYSQL_DB": "admin-demo","SCHEMA_DDL_PERMISSIONS": "true"}}}
}
配置说明
- 基础配置: 只允许查询操作（SELECT、SHOW等），安全性高
- 高级配置: 允许DDL操作（CREATE、DROP、ALTER等），功能完整但需谨慎使用
- SCHEMA_DDL_PERMISSIONS: 设置为 "true" 开启DDL权限
🔧 环境要求
MySQL 数据库
- 服务状态: 运行中
- 端口: 3306
- 用户: root
- 密码: root
- 数据库: admin-demo
系统环境
- 操作系统: Windows
- Node.js: 已安装
- npm: 已安装
- IDE: Trae.ai
🚀 使用步骤
基础使用（只读模式）
- 复制配置: 将基础配置的 JSON 复制到 Trae.ai 的 MCP 设置中
- 重启应用: 重启 Trae.ai 应用
- 测试连接: 在 Trae.ai 中测试 MySQL MCP 连接
- 开始使用: 通过自然语言查询数据库（仅支持查询操作）
高级使用（支持DDL操作）
- 复制高级配置: 将高级配置的 JSON 复制到 Trae.ai 的 MCP 设置中
- 重启应用: 重启 Trae.ai 应用
- 测试连接: 在 Trae.ai 中测试 MySQL MCP 连接
- 完整功能: 可以执行查询、创建表、修改表结构等所有操作
⚠️ 权限选择建议
- 学习环境: 推荐使用高级配置，方便学习和实验
- 生产环境: 推荐使用基础配置，确保数据安全
- 开发环境: 根据需要选择，建议先用基础配置测试连接
📝 常用命令
测试数据库连接
D:\phpstudy_pro\Extensions\MySQL5.7.26\bin\mysql.exe -u root -proot -e "SELECT 1;"
查看数据库列表
D:\phpstudy_pro\Extensions\MySQL5.7.26\bin\mysql.exe -u root -proot -e "SHOW DATABASES;"
检查 MySQL 服务状态
通过 PHPStudy 管理面板查看 MySQL 服务状态
⚠️ 重要提醒
版本说明
- ✅ 推荐版本: 2.0.2（稳定）
- ❌ 避免版本: 2.0.5（Windows 兼容性问题）
配置注意事项
- 每次修改配置后必须重启 Trae.ai
- 确保 MySQL 服务正在运行
- 确保数据库
admin-demo存在 - 用户
root需要有访问权限
🔍 故障排除
如果连接失败
- 检查 MySQL 服务: 确保 MySQL 正在运行
- 验证数据库: 确认
admin-demo数据库存在 - 测试连接: 使用命令行测试数据库连接
- 重启应用: 重启 Trae.ai 应用
- 检查版本: 确认使用的是 2.0.2 版本
如果无法执行DDL操作
- 检查配置: 确认使用的是高级配置
- 验证权限: 确认配置中包含
"SCHEMA_DDL_PERMISSIONS": "true" - 重启应用: 修改配置后必须重启 Trae.ai
- 测试权限: 尝试执行简单的 CREATE TABLE 语句
常见错误
- MCP error -32008: 通常是版本问题，使用 2.0.2 版本解决
- 连接超时: 检查 MySQL 服务状态
- 权限错误: 检查用户权限设置
- DDL operations are not allowed: 需要使用高级配置开启DDL权限
📞 技术支持
如果遇到问题：
- 检查本文档的故障排除部分
- 确认环境配置正确
- 联系 Trae.ai 技术支持
状态: ✅ 验证可用
适用环境: Windows + Trae.ai + MySQL