Programa de solução de problemas de erros comuns
Quando o sistema solicitar spawn uvx ENOENT Quando o erro ocorre, significa que o cliente não consegue localizar o executável uvx, o que pode ser resolvido com as seguintes etapas:
Processo de diagnóstico aprofundado
- Validação de caminho:
Executar no terminalwhich uvxObter o caminho absoluto para o arquivo executável
(Exemplo de caminho típico:
macOS./usr/local/bin/uvx
Windows.C:Users用户名AppDataLocalastralbinuvx.exe) - Correção de configuração:
Modifique o arquivo de configuração do cliente substituindo o valor do comando pelo caminho completo:"command": "/usr/local/bin/uvx"
- Inspeções ambientais:
Certifique-se de que o PATH do sistema contenha o diretório onde o uvx está localizado.
Os usuários do Windows precisam verificar a configuração da variável de ambiente
Medidas preventivas
- Certifique-se de que a opção "Add to PATH" esteja marcada ao instalar o uv
- Reinicie o terminal/IDE para que as variáveis de ambiente tenham efeito
- Para ambientes Docker, o uv precisa ser explicitamente instalado durante a fase de criação da imagem.
alternativa
Se isso ainda não resolver o problema, você pode executá-lo com o pip:
"command": "python",
"args": ["-m", "elevenlabs_mcp"]
O problema ocorre principalmente em sistemas Windows e em algumas distribuições Linux. O caso do 90% pode ser resolvido com a correção da configuração do caminho.
Essa resposta foi extraída do artigoMCP da ElevenLabs: serviço de MCP de geração de falaO































