前言

本文旨在为 TRAE（字节AI IDE）用户提供一份完整的 MySQL MCP 配置指南。无论您是希望让 AI 智能体协助数据库查询、数据分析，还是自动化执行 SQL 操作，通过本文的步骤都能快速搭建起安全、可用的连接环境。

目标读者

• TRAE 用户：希望扩展 AI 能力到数据库操作
• 开发者/数据分析师：需要自然语言交互方式操作 MySQL
• 团队管理者：关注数据库访问安全与权限控制

解决的问题

1. 安全隔离：避免直接使用 root 账号，创建专用账号并遵循最小权限原则
2. 环境依赖：解决 MCP 服务所需的 uv/uvx 包管理器安装
3. 可视化配置：在 TRAE 界面中完成 MySQL MCP 连接设置
4. 智能体绑定：将数据库能力赋予 AI 智能体
5. 自然语言交互：实现「说人话」操作数据库的终极体验

核心价值

• 提升效率：AI 自动编写、执行 SQL，减少手动操作时间
• 降低门槛：非技术人员也能通过自然语言进行数据库查询
• 安全保障：专用账号 + 权限控制，防止误操作风险
• 灵活扩展：支持只读/完整两种权限模式，适应不同场景需求

通过本教程，您将完成从零到一的完整配置，让 TRAE 的 AI 智能体成为您的「数据库助手」。

名词说明

• MCP：Model Context Protocol，模型上下文协议，让TRAE的AI智能体可以直接操控数据库、自动执行SQL、查表、建表、统计分析
• MVP：最小可用配置，完成「新建数据库专用账号→MCP连接配置→智能体绑定→自然语言操控数据库」全流程

阶段一：MySQL创建TRAE专用账号（安全规范，禁止直接用root）

1. 登录MySQL客户端

打开CMD/Navicat，执行登录命令

mysql -u root -p
-- 输入root密码进入mysql命令行

2. 创建专属账号 trae_mcp

-- 创建账号，仅允许本地访问
CREATE USER 'trae_mcp'@'localhost' IDENTIFIED BY '你的高强度密码';

-- 如果需要远程数据库访问，用这个（允许任意IP）
-- CREATE USER 'trae_mcp'@'%' IDENTIFIED BY '你的高强度密码';

3. 分配数据库权限（最小权限原则）

方案A：只读模式（推荐，防止AI误删数据）

-- 仅给指定数据库 查、查看表结构权限，不能增删改
GRANT SELECT, SHOW VIEW, INFORMATION_SCHEMA ON 你的库名.* TO 'trae_mcp'@'localhost';

方案B：完整操控模式（允许建表、增删改查，开发调试用）

-- 对指定数据库赋予全部操作权限
GRANT ALL PRIVILEGES ON 你的库名.* TO 'trae_mcp'@'localhost';

4. 刷新权限生效

FLUSH PRIVILEGES;

5. 验证账号可用性

-- 退出root，测试新账号登录
exit
mysql -u trae_mcp -p
-- 输入密码，能正常登录即账号创建完成

---

阶段二：前置环境准备（uv包管理器，MCP依赖必备）

MCP服务依赖uv/uvx运行，首次配置必须安装

Windows（PowerShell管理员执行）

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Mac / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

验证安装

新开终端执行

uvx --version
# 输出版本号即安装成功

---

阶段三：TRAE内配置MySQL MCP连接（可视化步骤）

1. 打开TRAE，右侧AI聊天框右上角 ⚙设置 → 点击 MCP 进入MCP管理面板

2. 点击 +添加 → 从市场添加，搜索 MySQL，点击MySQL条目右侧 + 添加

3. 在弹窗填写数据库连接信息：

   参数	填写示例	说明
   MYSQL_HOST	localhost	本地数据库填localhost，远程填IP地址
   MYSQL_PORT	3306	MySQL默认端口
   MYSQL_USER	trae_mcp	上一步新建的账号名
   MYSQL_PASSWORD	你的高强度密码	新建账号密码
   MYSQL_DATABASE	你的库名	需要操控的目标数据库名

4. 点击确认提交配置，首次弹出Python/UV环境安装弹窗，直接点安装自动补全依赖

5. 返回MCP列表，打开MySQL开关，显示绿色启用、日志无报错 → MCP连接配置完成

手动JSON配置方案（市场添加失败时用）

点击「手动添加」，粘贴配置，替换连接信息

{
  "mcpServers": {
    "mysql": {
      "command": "uvx",
      "args": [
        "--from",
        "mysql-mcp-server",
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "trae_mcp",
        "MYSQL_PASSWORD": "你的高强度密码",
        "MYSQL_DATABASE": "你的库名"
      }
    }
  }
}

---

阶段四：绑定MCP到TRAE智能体（AI才能调用数据库）

1. MCP页面展开MySQL条目，点击 添加到智能体
2. 两种选择：
   • SOLO内置智能体：直接勾选MySQL工具，保存即可全局生效
   • 新建自定义智能体：命名「数据库助手」，提示词填写：你可以操作MySQL数据库，根据我的自然语言需求自动查询、编写、执行SQL，返回数据结果与分析
3. 勾选已配置的MySQL MCP服务，点击创建/保存

---

阶段五：使用方式（自然语言操控数据库）

进入对应智能体对话窗口，直接发自然语言指令，AI自动感知表结构、执行SQL并返回结果

示例指令1：查询表列表

帮我列出当前数据库所有数据表

示例指令2：数据查询统计

查询users表总共有多少条用户，统计男女数量

示例指令3：建表、改表结构

创建订单表order，包含id主键、user_id、金额、下单时间字段

示例指令4：生成报表分析

统计近7天订单销售额，生成汇总数据

底层逻辑

AI自动调用MCP内置execute_sql工具，自动拼接、校验、执行SQL，不用手动写语句

---

常见报错排错

1. 报错：spawn uvx ENOENT
   原因：uv未安装或环境变量未生效
   解决：重装uv，关闭TRAE重启电脑，新开终端确认uvx --version正常

2. 数据库连接拒绝/访问被拒

   • 核对账号密码、IP、端口、数据库名
   • 检查MySQL是否开启远程访问、防火墙放行3306端口
   • 确认账号权限已刷新FLUSH PRIVILEGES;

3. MCP开启后频繁断开
   检查MySQL超时配置，或改用只读账号降低操作风险

4. AI无法调用SQL工具
   确认智能体配置中已勾选MySQL MCP开关，MCP状态为绿色启用

总结

通过以上五个阶段的配置，您已经成功将 TRAE 的 AI 智能体与 MySQL 数据库连接起来。让我们回顾一下关键步骤：

配置流程回顾

1. 账号安全先行：创建专用账号 trae_mcp，遵循最小权限原则分配只读或完整权限
2. 环境准备：安装 uv/uvx 包管理器，确保 MCP 服务依赖就绪
3. 可视化配置：在 TRAE 的 MCP 管理面板中添加 MySQL 服务，填写连接信息
4. 智能体绑定：将 MySQL MCP 服务绑定到 SOLO 内置智能体或创建自定义「数据库助手」
5. 自然语言交互：通过简单的对话指令，让 AI 自动执行 SQL 操作

安全性强调

• 永远不要使用 root 账号：专用账号能有效隔离风险
• 最小权限原则：生产环境优先使用只读权限，防止 AI 误删数据
• 密码强度：为 trae_mcp 账号设置高强度密码
• 网络隔离：本地环境使用 localhost，远程访问需谨慎配置防火墙

最佳实践建议

1. 开发 vs 生产：开发环境可使用完整权限模式，生产环境务必使用只读模式
2. 定期验证：定期检查账号权限和 MCP 连接状态
3. 指令明确：给 AI 的指令尽量具体，避免歧义
4. 结果验证：重要操作前，先通过测试查询验证 AI 的理解准确性
5. 备份意识：在进行表结构修改或数据删除前，确保有数据备份

未来扩展

配置完成后，您可以：

• 探索更多 MCP 服务（如 PostgreSQL、MongoDB 等）
• 创建多个专用智能体，分别处理不同数据库或业务场景
• 结合 TRAE 的其他 AI 功能，构建完整的智能开发工作流

现在，您可以开始享受自然语言操控数据库的便捷体验了。只需在对话窗口中输入您的需求，AI 将自动处理剩下的所有技术细节，让您更专注于业务逻辑和数据分析本身。