Solução para o mcp-ui que não consegue chamar ferramentas externas
Quando o mcp-ui não consegue invocar uma ferramenta externa, isso pode ser devido a um erro de configuração, um serviço não iniciado ou um problema de definição da ferramenta. Veja a seguir as soluções específicas:
- Verifique se o serviço MCP está funcionando corretamenteVerifique se o serviço de back-end do MCP foi iniciado (
npm run mcp:server
) e verifique se há erros relatados no terminal. - Configuração da ferramenta de validação: Inspeção
mcp_server.js
Certifique-se de que os nomes, os parâmetros e as descrições das ferramentas estejam definidos corretamente, por exemplo, a ferramenta do navegador precisa incluir o parâmetroname: "browser"
. - Teste de conectividade de APIDigite um comando simples na caixa de bate-papo (por exemplo, "Open Google Search AI") e veja se o registro de chamadas da ferramenta é retornado. Se não houver resposta, pode ser um conflito de porta (padrão 3001), você pode alterar o seguinte
.env
acertou em cheioMCP_SERVER_PORT
. - Verificação de dependências: Executar
npm ls
Verifique se todas as dependências (por exemplo@mcp/core
) é instalado e pode ser executado novamente se estiver faltando.npm install
.
Se o problema continuar sem solução, tente as seguintes soluções alternativas:
- Reinicie todos os serviços (front-end, back-end, Electron).
- Verifique a página de problemas do projeto no GitHub e procure problemas semelhantes.
- Verifique na guia Rede das Ferramentas do desenvolvedor (F12) se a solicitação de API está sendo enviada corretamente.
Essa resposta foi extraída do artigomcp-ui: uma interface de bate-papo com IA limpa baseada no protocolo MCPO