1. MCP 与 AI 智能体的关系
1.1 核心概念区别
AI 智能体 (AI Agent) 是具备感知、推理、决策和行动能力的智能系统。在 Trae 中,与你对话的 AI 助手就是这个智能体。它擅长处理自然语言、理解用户意图、生成代码和解释逻辑。但在默认情况下,它是一个被隔离的机器,拥有海量的通用知识,却无法直接访问你的本地数据库或私有 API。
MCP (Model Context Protocol) 即模型上下文协议。它不是智能本身,而是一个开放标准,一套通讯协议和接口规范。它类似于计算机领域的 USB 标准,旨在连接 AI 模型与外部数据或工具。只要设备符合这个标准,就可以被 AI 智能体使用。
1.2 它们是如何联结的?
MCP 充当了 AI 智能体与外部工具或数据之间的桥梁,使 AI 能够直接调用和操作这些资源。
mcp-server-mysql 作为一个 MCP Server,将 MySQL 的连接、查询和查看表结构等原始能力封装成符合 MCP 标准的工具 (Tools) 和资源 (Resources)。
Trae 编辑器作为 MCP Client 连接到该 Server。当你发出查询指令时,AI 智能体分析意图,识别出可以通过 MCP 连接的 SQL 工具,从而决定调用它。
最后形成闭环执行:AI 生成请求,通过 MCP 通道传输给 Server,Server 执行 SQL 并从数据库获取结果,再格式化返回给 AI,最终由 AI 解释并呈现给你。
1.3 形象比喻
如果把开发过程比作驾驶汽车,AI 智能体就是驾驶员,负责思考路线和做决定;MySQL 数据库是汽车引擎,提供动力和数据;而 MCP 就是方向盘、油门和仪表盘。没有 MCP,驾驶员虽然聪明却无法直接控制引擎;有了 MCP,驾驶员就可以通过标准的操作接口来驾驭引擎,获取数据或改变状态。

2. 前置条件
在配置之前,安装 uv 工具(Python 包管理器),使用它来运行 MCP Server。
powershell
pip install uv
3. 在 Trae 中配置 MySQL MCP
3.1 从 MCP 市场添加 MCP Server
在 IDE 模式界面中,点击MCP智能体的添加更多工具,可以进入MCP管理中心

点击 添加 > 从市场添加

搜索 MySQL Server

点击 + 号按钮,输入MySQL配置信息

3.2 配置 MySQL 数据库
配置项说明:
command 指定启动命令,这里使用 uvx 来动态运行 Python 包。
args 是传递给命令的参数列表。
env 包含了 MySQL 数据库的连接信息,包括数据库名、主机地址、端口、用户名和密码。
json
{
"mcpServers": {
"MySQL Server": {
"command": "uvx",
"args": [
"--from",
"mysql-mcp-server",
"mysql_mcp_server"
],
"env": {
"MYSQL_DATABASE": "database",
"MYSQL_HOST": "localhost",
"MYSQL_PASSWORD": "mysql_123456",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root"
}
}
}
}
点击 确认,系统会提示 "MySQL 配置已提交"

4. 如何使用 (Usage)
配置成功并重启 Trae 后,选择Builder with MCP 就可以像与真人对话一样,让 AI 助手帮你操作数据库了。

4.1 场景一:理解数据库结构
当你刚接手一个项目,不熟悉数据库表结构时,可以问:
🗣️ User: "请列出当前数据库的所有表,并解释一下 sys_user 表的主要字段含义。"
🤖 AI: (调用 list_tables 和 describe_table 工具) "当前数据库包含 sys_user, sys_role 等表。sys_user 表包含 user_id(主键)、user_name(用户名)..."
4.2 场景二:执行数据查询
你无需手写 SQL,直接用自然语言描述需求:
🗣️ User: "查询最近注册的 5 个用户,显示他们的用户名和创建时间。"
🤖 AI: (生成并执行 SELECT user_name, create_time FROM sys_user ORDER BY create_time DESC LIMIT 5) "这是查询结果:..."
4.3 场景三:辅助 SQL 编写与调试
当你需要编写复杂的 JOIN 查询但卡住时:
🗣️ User: "我想查询所有用户的角色信息,需要关联 sys_user 和 sys_role 表,帮我写一个 SQL 并执行验证一下。"
🤖 AI: (先查看表关联结构,然后生成 SQL,执行 execute_sql 确认无误) "已为您生成并验证了 SQL,结果如下:..."
4.4 场景四:智能数据分析
你可以让 AI 对查询结果进行简单的分析:
🗣️ User: "统计一下各部门的用户数量分布。"
🤖 AI: (执行 GROUP BY 查询) "统计结果如下:研发部 10 人,市场部 5 人..."
5. 常见问题排查
- 连接被拒绝:请确保 MySQL 服务正在运行,检查防火墙是否允许 3306 端口连接,并确认密码正确。
- uvx 命令未找到:请确保已运行 pip install uv。尝试使用绝对路径运行 uvx。
- 乱码问题:确保数据库连接字符串中指定了正确的字符集,MCP Server 默认通常使用 UTF-8。
6. 手动调试(可选)
如果需要脱离 Trae 手动测试 MCP Server,可以使用以下命令启动 Inspector 界面:
powershell
npx @modelcontextprotocol/inspector uvx mcp-server-mysql --db-host localhost --db-user root --db-password your_password --db-name xinyeiot
参考:
https://github.com/designcomputer/mysql_mcp_server