Qoder CN Series:Perguntas frequentes sobre MCP

1. Ambiente ausente para o comando npx

• Mensagem de erro: failed to start command: exec: "npx": executable file not found in $PATH

• Solução: Baixe e instale o Node.js.

• Acesse o site oficial do Node.js para baixar e instalar o Node.js 18 ou uma versão posterior, ou siga estas etapas:

  Etapas de instalação e verificação

  Windows

  1. Baixe e instale o nvm-windows para gerenciar várias versões.

     nvm install 22.14.0  # Install a specific version
     nvm use 22.14.0

     2. Após concluir a instalação, execute o seguinte comando no terminal para verificar a instalação.

     node -v
     npx -v

     3. Se a instalação for bem-sucedida, o terminal exibirá o número da versão do Node.js instalada.

  macOS

  Baixe e instale o Node.js usando o Homebrew. Primeiro, instale o Homebrew.

  # 1. Install or update Homebrew<p># 1. Update Homebrew and install Node.js</p>
  brew update
  brew install node
  
  # 2. Verify the core toolchain
  echo "Node.js version: $(node -v)"
  echo "npm version: $(npm -v)"
  echo "npx version: $(npx -v)"
  
  # 3. Configure environment variables (if necessary)
  echo 'export PATH="/usr/local/opt/node@16/bin:$PATH"' >> ~/.zshrc

2. Ambiente ausente para o comando uvx

• Mensagem de erro: failed to start command: exec: "uvx": executable file not found in $PATH

• Solução: Instale o uv. O uvx é uma interface de linha de comando fornecida pelo uv para executar scripts Python rapidamente.

  • Acesse o site oficial do Python para baixar e instalar o Python 3.8 ou uma versão posterior, ou siga estas etapas:

    Etapas de instalação e verificação

    1. Baixe e instale

       Windows system

       No Windows, execute o seguinte comando para instalar.

       powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

       macOS

       No macOS e Linux, execute o seguinte comando para instalar.

       curl -LsSf https://astral.sh/uv/install.sh | sh

    2. Após concluir a instalação, execute o seguinte comando no terminal para verificar a instalação.

       uv --version

    3. Se a instalação for bem-sucedida, o terminal exibirá o número da versão do uv instalada.

3. Falha ao inicializar o MCP Client

• Mensagem de erro: failed to initialize MCP client: context deadline exceeded

• Possíveis causas:

  • Configurações incorretas de parâmetros do service: Os parâmetros do service MCP estão incorretos, o que impede a inicialização do service.

  • Falha ao obter recursos: A instalação falha porque problemas de rede impedem a obtenção dos recursos.

  • Restrições de segurança de rede: O service MCP não consegue inicializar porque foi bloqueado por software de segurança corporativo interno.

• Etapas de solução de problemas:

npm config set registry https://registry.npmmirror.com

export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/

1. Falha na execução da ferramenta devido a variáveis de ambiente ou parâmetros incorretos

2. O modelo não consegue chamar ferramentas MCP

• Confirme se você está no modo Agent.

  Importante

  Se nenhuma pasta de projeto estiver aberta, o sistema entra no modo AI Chat e não consegue chamar ferramentas MCP. Primeiro, carregue a pasta de projeto correspondente e mude para o modo Agent.

• Confirme se o service MCP está no estado Connected:

• Recomendação: Evite usar nomes semelhantes para services MCP e suas ferramentas. Por exemplo, se tanto o TextAnalyzer-Pro quanto o TextAnalyzer-Plus tiverem uma ferramenta chamada fetchText com funções similares, isso pode causar ambiguidade quando o modelo fizer a chamada.

3. As configurações pessoais e a página de ferramentas MCP não abrem, e o painel de sessão fica em branco

Esse problema ocorre quando a página fica em branco e o arquivo idea.log contém a seguinte mensagem de erro: "WARN - #c.i.u.j.JBCefApp - JCefAppConfig.class is not from a JBR module".

Causa: As configurações padrão no Android Studio não oferecem suporte ao JCEF. Isso impede o carregamento de páginas, como Configurações Pessoais e a página de ferramentas MCP.

Solução:

4. Falha ao carregar a lista de services MCP

A lista de services fica travada em estado de carregamento.

• Reinicie a IDE.

• Se o problema persistir, inicie o service Lingma manualmente:

  Windows system

  Acesse o diretório .lingma/bin/x.x.x/CPU_architecture_64_system/.

  Execute o comando:

  Lingma.exe start

  macOS

  Clique em no ícone da Apple no canto superior esquerdo da tela e selecione About This Mac para visualizar o modelo do seu processador. Em seguida, navegue até o diretório correspondente com base no modelo do seu processador.

  • Chip M1: /.lingma/bin/x.x.x/aarch64_darwin/Lingma

  • Chip Intel: /.lingma/bin/x.x.x/x86_64_darwin/Lingma

  Execute o comando:

  Lingma start

  Após o início do service, clique em novamente no botão de login.