mcphub.nvim MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Marketplace verificado de servidores MCP com instalação em um comando
Suporte completo de recursos MCP: tools, resources, templates, prompts
OAuth PKCE + autenticação por chave API
Integração com Avante.nvim, CodeCompanion.nvim, CopilotChat.nvim
Mesclagem de configuração local do projeto, sintaxe de configuração JSON5

Demo ao vivo

Como fica na prática

mcphub-nvim.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcphub-nvim": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcphub-nvim",
      "command": "TODO",
      "args": [
        "See README: https://github.com/ravitemer/mcphub.nvim"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcphub-nvim": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/ravitemer/mcphub.nvim"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add mcphub-nvim -- TODO 'See README: https://github.com/ravitemer/mcphub.nvim'

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: mcphub.nvim

Como usar servidores MCP do Neovim via Avante ou CodeCompanion

👤 Desenvolvedores do Neovim ⏱ ~20 min intermediate

Quando usar: Você vive no Neovim e não quer mudar para VS Code para acessar MCP.

Pré-requisitos

Neovim 0.10+ — brew install neovim
Avante.nvim ou CodeCompanion.nvim instalado — Via seu gerenciador de plugins (lazy.nvim/packer)
mcphub.nvim + sua dependência Node — Veja ravitemer.github.io/mcphub.nvim para o trecho de instalação

Fluxo

Instale via gerenciador de plugins

Adicione ravitemer/mcphub.nvim à sua configuração lazy.nvim com opts = { ... }.✓ Copiado

→ :MCPHub abre a UI de gerenciamento
Instale um servidor do marketplace

:MCPHub marketplace — pesquise 'github' e instale.✓ Copiado

→ Servidor inicia, tools registradas
Use via Avante

No chat Avante, faça uma pergunta — Avante seleciona as MCP tools.✓ Copiado

→ Chamadas de tool visíveis na saída do Avante

Resultado: MCP tools utilizáveis dentro do seu editor, sem mudança de contexto.

Armadilhas

Node não está no PATH dentro do Neovim — Use um caminho absoluto na configuração ou garanta que o Neovim herde seu shell env

Como configurar servidores MCP locais do projeto que se mesclam com global

👤 Desenvolvedores políglotas com diferentes ferramentas por projeto ⏱ ~15 min intermediate

Quando usar: Um projeto precisa de postgres MCP, outro precisa de um MCP interno customizado.

Fluxo

Crie .mcphub.json5 na raiz do projeto

Defina servidores específicos do projeto em .mcphub.json5.✓ Copiado

→ Servidores carregam automaticamente quando você abre o projeto
Verifique a mesclagem

:MCPHub status — veja quais servidores são globais vs projeto.✓ Copiado

→ Visualização mesclada

Resultado: Carregamento de tools consciente do contexto por projeto.

Armadilhas

Cometer segredos em .mcphub.json5 — Use referências de variáveis de ambiente, gitignore o arquivo se ele deve conter tokens

Como iterar em um servidor MCP customizado do Neovim

👤 Autores de servidores MCP ⏱ ~15 min advanced

Quando usar: Você está construindo um servidor e deseja iteração rápida.

Fluxo

Habilite o modo dev

Adicione seu servidor com dev=true na configuração mcphub.✓ Copiado

→ Recarga em tempo real ao salvar o arquivo
Itere

Edite o código do servidor; mcphub o reinicia transparentemente.✓ Copiado

→ Tools atualizadas sem reiniciar o Neovim

Resultado: Ciclo de desenvolvimento compacto dentro do Neovim.

Combinações

Combine com outros MCPs para 10× de alavancagem

mcphub-nvim + github

Use GitHub MCP do Neovim via chat Avante

Instale github MCP via marketplace, então peça ao Avante para mostrar PRs atribuídos a mim.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
(plugin) :MCPHub	Comandos: status, marketplace, install, logs	Gerencie servidores	free
(plugin) marketplace-install	server_name	Adicione rapidamente um MCP verificado	free
(integration) Avante/CodeCompanion/CopilotChat tools	Chat prompts	Uso normal de chat	1 LLM call + tool calls

Custo e limites

O que custa rodar

Cota de API: Nenhuma (plugin em si)
Tokens por chamada: Adiciona uma lista de tools aos prompts do Avante/CC
Monetário: Gratuito (MIT)
Dica: Desabilite servidores de marketplace não utilizados — cada um adiciona tools ao seu orçamento de prompt.

Segurança

Permissões, segredos, alcance

Escopos mínimos: O que cada MCP instalado precisar

Armazenamento de credenciais: Referências de variáveis de ambiente na configuração mcphub

Saída de dados: Por MCP downstream

Nunca conceda: Não faça commit de .mcphub.json5 com segredos embutidos

Entradas do marketplace são enviadas pela comunidade — verifique o editor antes de instalar.

Solução de problemas

Erros comuns e correções

mcphub falha ao iniciar o subprocesso Node

O PATH do Neovim pode não incluir Node. Defina vim.env.PATH ou use um caminho absoluto.

Verificar: :!which node

Avante não vê MCP tools

Verifique a versão do adaptador Avante — versões antigas não suportam MCP. Atualize.

Marketplace mostra lista vazia

Rede/firewall bloqueando URL do marketplace. Verifique os logs do :MCPHub.

Fluxo OAuth travado no navegador

Copie a URL dos logs do :MCPHub e cole manualmente; o redirecionamento localhost pode não funcionar no contexto do Neovim.

Alternativas

mcphub.nvim vs. outros

Alternativa	Quando usar	Troca
CodeCompanion.nvim (nativo)	Você quer chat LLM sem gerenciamento de MCP	Sem marketplace, sem fluxos OAuth
VS Code MCP	Você prefere VS Code	Não é Neovim

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills