trae 配置mysql_mcp

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

🚀 使用步骤

基础使用（只读模式）

1. 复制配置: 将基础配置的 JSON 复制到 Trae.ai 的 MCP 设置中
2. 重启应用: 重启 Trae.ai 应用
3. 测试连接: 在 Trae.ai 中测试 MySQL MCP 连接
4. 开始使用: 通过自然语言查询数据库（仅支持查询操作）

高级使用（支持DDL操作）

1. 复制高级配置: 将高级配置的 JSON 复制到 Trae.ai 的 MCP 设置中
2. 重启应用: 重启 Trae.ai 应用
3. 测试连接: 在 Trae.ai 中测试 MySQL MCP 连接
4. 完整功能: 可以执行查询、创建表、修改表结构等所有操作

⚠️ 权限选择建议

• 学习环境: 推荐使用高级配置，方便学习和实验
• 生产环境: 推荐使用基础配置，确保数据安全
• 开发环境: 根据需要选择，建议先用基础配置测试连接

📝 常用命令

测试数据库连接

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 需要有访问权限

🔍 故障排除

如果连接失败

1. 检查 MySQL 服务: 确保 MySQL 正在运行
2. 验证数据库: 确认 admin-demo 数据库存在
3. 测试连接: 使用命令行测试数据库连接
4. 重启应用: 重启 Trae.ai 应用
5. 检查版本: 确认使用的是 2.0.2 版本

如果无法执行DDL操作

1. 检查配置: 确认使用的是高级配置
2. 验证权限: 确认配置中包含 "SCHEMA_DDL_PERMISSIONS": "true"
3. 重启应用: 修改配置后必须重启 Trae.ai
4. 测试权限: 尝试执行简单的 CREATE TABLE 语句

常见错误

• MCP error -32008: 通常是版本问题，使用 2.0.2 版本解决
• 连接超时: 检查 MySQL 服务状态
• 权限错误: 检查用户权限设置
• DDL operations are not allowed: 需要使用高级配置开启DDL权限

📞 技术支持

如果遇到问题：

1. 检查本文档的故障排除部分
2. 确认环境配置正确
3. 联系 Trae.ai 技术支持

---

状态: ✅ 验证可用
适用环境: Windows + Trae.ai + MySQL