在使用 Trae 工具遠(yuǎn)程訪問(wèn)內(nèi)網(wǎng) MySQL 數(shù)據(jù)庫(kù)時(shí)，我遇到了從本地啟動(dòng)失敗到認(rèn)證兼容報(bào)錯(cuò)的一系列問(wèn)題。經(jīng)過(guò)逐步排查，最終通過(guò)本地命令映射+環(huán)境變量注入的方式完美解決，現(xiàn)將完整方案分享給大家。

一、問(wèn)題背景

Trae 作為開(kāi)發(fā)常用工具，支持通過(guò) MCP 插件連接各類(lèi)中間件。我在配置 MySQL MCP 時(shí)，先后遇到兩個(gè)核心報(bào)錯(cuò)：

• 啟動(dòng)時(shí)報(bào)錯(cuò) spawn uvx ENOENT，本地 MCP 服務(wù)無(wú)法啟動(dòng)；
• 解決啟動(dòng)問(wèn)題后，出現(xiàn) Request timed out (-32001) 連接超時(shí)，而同一網(wǎng)絡(luò)環(huán)境下 MySQL Workbench 可正常連接、Trae Redis MCP 可正常使用。

環(huán)境信息：

• 系統(tǒng)：Windows 11
• MySQL 版本：8.xxx（默認(rèn)認(rèn)證插件 caching_sha2_password）
• 網(wǎng)絡(luò)：VPN 遠(yuǎn)程訪問(wèn)內(nèi)網(wǎng)數(shù)據(jù)庫(kù)

二、核心問(wèn)題定位

1.uvx ENOENT根源：Windows 系統(tǒng)命令后綴兼容缺陷

trae輸出日志：

[info] [mcp.config.usrlocalmcp.MySQL] MCPServerManager#start Connecting with config... {"command":"uvx","args":["--from","mysql-mcp-server","mysql_mcp_server"],"env":………………
……
[error] [mcp.config.usrlocalmcp.MySQL] MCPClient#onError 發(fā)生了系統(tǒng)錯(cuò)誤 (spawn uvx ENOENT)

MySQL MCP 依賴(lài) uvx 命令啟動(dòng)，但 Windows 系統(tǒng)執(zhí)行可執(zhí)行文件時(shí)必須帶 .exe 后綴，而 Trae 配置中直接調(diào)用 uvx，導(dǎo)致系統(tǒng)無(wú)法識(shí)別對(duì)應(yīng)的 uvx.exe 文件。

更關(guān)鍵的是，MCP 配置界面為只讀狀態(tài)，無(wú)法修改 command 配置項(xiàng)，本地配置文件要么是二進(jìn)制格式，要么路徑隱藏，無(wú)法直接編輯。

2.Request timed out根源：MySQL 8.x 認(rèn)證插件不兼容

排除 VPN 網(wǎng)絡(luò)、端口白名單、賬號(hào)密碼等因素后（Workbench 可正常連接），定位到核心矛盾：

• MySQL 8.x 默認(rèn)認(rèn)證插件為 caching_sha2_password；
• MySQL MCP 默認(rèn)使用舊版插件 mysql_native_password；
• 且 Trae 未開(kāi)放認(rèn)證插件配置入口，普通賬號(hào)無(wú)權(quán)限修改 MySQL 服務(wù)端賬號(hào)的認(rèn)證插件。

三、分步解決方案

步驟 1：創(chuàng)建uvx.cmd映射文件，解決本地啟動(dòng)問(wèn)題

通過(guò)創(chuàng)建批處理文件，讓系統(tǒng)執(zhí)行 uvx 命令時(shí)自動(dòng)調(diào)用 uvx.exe，繞開(kāi) Trae 配置限制。

1. 找到 uvx.exe 所在路徑（可從 Trae 日志中提?。?/p>

   C:\Users\你的用戶(hù)名\.trae-cn\tools\uv\latest

2. 在該文件夾下新建文本文檔，重命名為 uvx.cmd（需顯示文件擴(kuò)展名）；

3. 編輯 uvx.cmd，寫(xiě)入以下內(nèi)容并保存：

   @echo off
   "%~dp0uvx.exe" %*

4. 徹底關(guān)閉 Trae（任務(wù)管理器結(jié)束進(jìn)程），重新啟動(dòng)，ENOENT 報(bào)錯(cuò)消失。

步驟 2：升級(jí)uvx.cmd，注入認(rèn)證插件參數(shù)解決兼容問(wèn)題

在 uvx.cmd 中添加環(huán)境變量，強(qiáng)制 MySQL MCP 使用 caching_sha2_password 認(rèn)證插件，無(wú)需修改 Trae 任何配置。

修改后的 uvx.cmd 完整內(nèi)容：

@echo off
:: 強(qiáng)制注入MySQL8.x認(rèn)證插件參數(shù)
set MYSQL_AUTH_PLUGIN=caching_sha2_password
:: 延長(zhǎng)超時(shí)時(shí)間適配VPN
set MYSQL_CONNECT_TIMEOUT=60000
:: 啟動(dòng)uvx.exe并傳遞所有參數(shù)
"%~dp0uvx.exe" %*

保存后重啟 Trae，MySQL MCP 成功連接，日志顯示 Connected.。

四、驗(yàn)證結(jié)果

啟動(dòng) Trae 后，查看日志，出現(xiàn)以下內(nèi)容代表成功：

[info] [mcp.config.usrlocalmcp.MySQL] MCPClient#onStderr [Server Internal Log] Starting MySQL MCP server with config:

此時(shí)可在 Trae 中正常執(zhí)行 SQL 查詢(xún)。

五、總結(jié)與反思

本次問(wèn)題本質(zhì)是 MySQL MCP 對(duì) Windows 系統(tǒng)和 MySQL 版本的兼容性缺陷：

• 未適配 Windows 可執(zhí)行文件后綴規(guī)則，導(dǎo)致本地啟動(dòng)失??；
• 未開(kāi)放認(rèn)證插件配置，且默認(rèn)插件與 MySQL 8.x 不兼容。

通過(guò)命令映射+環(huán)境變量注入的方式，無(wú)需修改工具源碼和數(shù)據(jù)庫(kù)權(quán)限，即可低成本解決問(wèn)題。該方案同樣適用于其他 MCP 插件的類(lèi)似兼容性問(wèn)題。

到此這篇關(guān)于Trae MySQL MCP 連接失敗(Fail to start)的問(wèn)題解決的文章就介紹到這了,更多相關(guān)Trae MySQL MCP 連接失敗內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論