在 Trae 中配置 MySQL-MCP 服务器的完整指南

💡 提示：若使用 Docker 版 MySQL，将 MYSQL_HOST 改为 host.docker.internal。

步骤 3：验证配置

在终端执行测试命令：

mysql_mcp_server list-tables

若输出类似如下内容，说明配置成功：

["users", "orders", "products", "customers"]

💡 高级用法：让 Trae 变得更智能

🌐 场景 1：自然语言转 SQL 查询

安装额外的自然语言处理扩展：

pip install xiyan-mcp-server

然后在 MCP 配置中添加：

{
  "mcpServers": {
    "xiyan": {
      "command": "uvx",
      "args": ["--from", "xiyan-mcp-server"],
      "env": {
        "MODEL_API_KEY": "sk-你的 API 密钥"
      }
    }
  }
}

现在，你可以在 Trae 中输入：

'统计过去一周订单量最高的前 5 个商品'

Trae 会自动生成并执行 SQL 返回结果。

📊 场景 2：自动化报表生成

结合 QuickChart-MCP 服务实现数据可视化：

{
  "mcpServers": {
    "quickchart": {
      "command": "npx",
      "args": ["@gongrzhe/quickchart-mcp-server"]
    }
  }
}

输入：

'生成近 7 天销售额的柱状图'

Trae 将自动生成图表。

🛠️ 常见问题排查

❌ 问题 1：MCP 工具不可用

解决方法：

1. 完全重启 Trae（关闭进程再打开）。
2. 检查 MCP 配置文件格式是否正确（JSON 格式）。
3. 验证 MCP 服务器包是否已正确安装。

❌ 问题 2：连接失败

解决方法：

1. 检查数据库连接参数（主机、端口、用户名、密码）。
2. 确认 MySQL 服务正在运行。
3. 验证网络连接（例如尝试 ping 127.0.0.1）。

❌ 问题 3：权限问题

解决方法：

1. 确保数据库用户拥有足够权限（SELECT、SHOW DATABASES 等）。
2. 检查数据库防火墙设置。
3. 为 MCP 创建专用账户，遵循最小权限原则。

📌 最佳实践建议

1. 安全第一：避免硬编码密码，优先使用环境变量。
2. 测试先行：配置完成后先用简单查询测试连通性。
3. 逐步扩展：先配置基本功能，再添加高级插件。