Trae MCP连接失败时需逐层排查：一、检查MCP服务是否运行（trae mcp status）；二、验证mysql_mcp_server命令是否可用及路径配置；三、Windows下解决spawn uvx ENOENT需创建uvx.cmd映射；四、核对数据库连接参数与认证插件兼容性；五、确认端口监听地址为0.0.0.0并关闭防火墙干扰。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Trae MCP连接失败时，你无法执行数据库查询、调用AI智能体或触发任何依赖MCP协议的工具操作，终端可能卡在“Connecting…”或直接报错spawn uvx ENOENT、Access denied、Request timed out(-32001)等信息，必须逐层验证本地服务、配置路径、认证机制与网络可达性。
确认MCP服务进程是否真实运行
第一步：打开终端，执行 trae mcp status 查看当前所有MCP服务状态。如果列表为空或MySQL条目显示 stopped，说明服务根本没启动成功。
第二步：手动启动对应服务，例如 trae mcp start --server=mysql。若命令立即退出且无日志输出，说明底层可执行文件缺失或权限被拒——此时不要继续配置，先解决启动问题。
第三步：用系统级命令验证进程是否存在。Windows上运行 tasklist | findstr "mysql_mcp_server"；macOS/Linux运行 ps aux | grep mysql_mcp_server。如果查不到任何进程，证明服务未运行，后续所有配置都无效。
检查mysql_mcp_server命令能否在终端直接执行
方法一：在任意终端窗口输入 mysql_mcp_server --version。如果提示“不是内部或外部命令”，说明该命令未安装或未加入PATH。
方法二：查找实际可执行路径。进入 ~/.trae-cn/tools/（macOS/Linux）或 %USERPROFILE%\.trae-cn\tools\（Windows），逐层翻找是否有 mysql_mcp_server 或 mysql_mcp_server.exe 文件。常见路径如：~/.trae-cn/tools/mysql-mcp-server/bin/mysql_mcp_server。
方法三：若只有源码目录（如 ~/servers/src/mysql），则需确保已执行 npm install 且 node index.js 能成功监听端口。此时Trae配置中“服务器命令”字段必须填完整路径，例如 node /home/user/servers/src/mysql/index.js，【不能只写 node index.js】。
绕过uvx ENOENT错误（Windows专属）
当你看到日志里明确出现 spawn uvx ENOENT，这是Windows系统找不到 uvx.exe 的典型表现——Trae调用的是 uvx，但系统要求带 .exe 后缀。
第一步：从Trae日志中提取uvx.exe实际位置，通常形如 C:\Users\XXX\.trae-cn\tools\uv\latest\。
第二步：在该目录下新建一个纯文本文件，命名为 uvx.cmd（注意扩展名必须是 .cmd，且需开启“显示文件扩展名”才能正确重命名）。
第三步：用记事本打开uvx.cmd，输入以下两行内容并保存：
@echo offuvx.exe %*
这一步创建了命令映射，让系统执行 uvx 时自动转调 uvx.exe。此后Trae无需修改任何配置即可识别命令。
验证MySQL连接参数与认证兼容性
第一步：打开 %USERPROFILE%\.trae\mcp.json（Windows）或 ~/.trae/mcp.json（macOS/Linux），定位到MySQL服务的 "env" 对象。
第二步：逐项核对 MYSQL_HOST、MYSQL_PORT、MYSQL_USER、MYSQL_PASSWORD、MYSQL_DATABASE 是否与数据库真实配置一致。特别注意：【密码中含 @ : / 等字符时，必须做URL编码，否则连接必然失败】。
第三步：若MySQL版本为8.0+，默认认证插件为 caching_sha2_password，而旧版MCP客户端仅支持 mysql_native_password。此时需登录MySQL执行：ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';，再刷新权限：FLUSH PRIVILEGES;。
测试端口监听与防火墙连通性
第一步：确认MCP服务是否真正监听了端口。执行 netstat -ano | findstr ":8080"（Windows）或 lsof -i :8080（macOS/Linux）。若无输出，说明服务未绑定端口，可能是配置中host设为127.0.0.1导致远程不可达。
第二步：检查监听地址。理想值应为 0.0.0.0:8080，而非 127.0.0.1:8080。后者只能本机访问，Trae IDE无法跨进程通信。
第三步：临时关闭Windows Defender防火墙或执行 sudo ufw disable（Ubuntu），排除防火墙拦截。测试通过后再按需放行对应端口。
