Principais etapas para resolver a compatibilidade entre plataformas do mcp-ui
O mcp-ui pode causar problemas devido a diferenças de sistema ao usar o empacotamento Electron:
- isolamento ambientalCrie ambientes de desenvolvimento separados para cada plataforma (Windows/macOS/Linux) usando o
nvmGerencie a versão do Node.js e garanta que ela seja compatível com opackage.json(usado em uma expressão nominal)enginesOs campos são consistentes. - Compilações específicas da plataformaExecutar comandos de compilação direcionados (por exemplo
npm run electron:buildwin), em vez de uma compilação genérica. Para Macs, é necessário um tratamento adicional das assinaturas, e o Windows requer a configuração donsisInstalador. - tratamento de dependênciasMódulos nativos (por exemplo
sharp) precisam ser recompilados para serem executados nas plataformas de destinonpm rebuildou usandoelectron-rebuild.
As perguntas mais frequentes são abordadas:
- Falsos positivos do antivírus do Windows: adicione uma assinatura digital ou envie uma reclamação de falsos positivos.
- Problema de permissões do macOS: em
Info.plistmédio prazoNSDocumentsFolderUsageDescription. - As dependências do Linux estão faltando: forneça o AppImage ou complemente-o!
apt-get/yumGuia de instalação.
Recomendações de teste:
- Teste multiplataforma usando máquinas virtuais ou ferramentas de CI, como o GitHub Actions.
- existir
electron-builder.ymlConfigure os requisitos mínimos da versão do sistema para a plataforma de destino na seção
Essa resposta foi extraída do artigomcp-ui: uma interface de bate-papo com IA limpa baseada no protocolo MCPO
































