常见错误排查方案
当系统提示 spawn uvx ENOENT
错误时,说明客户端无法定位到 uvx 执行程序,可通过以下步骤解决:
深度诊断流程
- 路径验证:
在终端执行which uvx
获取可执行文件绝对路径
(典型路径示例:
macOS./usr/local/bin/uvx
Windows.C:Users用户名AppDataLocalastralbinuvx.exe
) - 配置修正:
修改客户端config文件,替换command值为完整路径:"command": "/usr/local/bin/uvx"
- 环境检查:
确认系统PATH包含uvx所在目录
Windows用户需检查环境变量配置
Medidas preventivas
- 安装uv时确保勾选”Add to PATH”选项
- 重启终端/IDE使环境变量生效
- 对于Docker环境,需在镜像构建阶段显式安装uv
alternativa
如果仍无法解决,可以直接使用pip运行:
"command": "python",
"args": ["-m", "elevenlabs_mcp"]
该问题多发生在Windows系统和部分Linux发行版,90%的案例通过修正路径配置即可解决。
Essa resposta foi extraída do artigoMCP da ElevenLabs: serviço de MCP de geração de falaO