📅 发布时间：2026/6/19 0:16:51

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

trae 配置mysql_mcp