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

Por qué usarlo

Características clave

Marketplace verificado de servidores MCP con instalación de un comando
Soporte completo de características de MCP: herramientas, recursos, plantillas, prompts
OAuth PKCE + autenticación con clave API
Integración con Avante.nvim, CodeCompanion.nvim, CopilotChat.nvim
Fusión de configuración local del proyecto, sintaxis de configuración JSON5

Demo en vivo

Cómo se ve en la práctica

mcphub-nvim.replay ▶ listo

0/0

Instalar

Elige tu 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
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: mcphub.nvim

Cómo usar servidores MCP desde Neovim a través de Avante o CodeCompanion

👤 Desarrolladores de Neovim ⏱ ~20 min intermediate

Cuándo usarlo: Vives en Neovim y no quieres cambiar a VS Code para acceder a MCP.

Requisitos previos

Neovim 0.10+ — brew install neovim
Avante.nvim o CodeCompanion.nvim instalado — A través de tu gestor de plugins (lazy.nvim/packer)
mcphub.nvim + su dependencia de Node — Consulta ravitemer.github.io/mcphub.nvim para el fragmento de instalación

Flujo

Instala a través del gestor de plugins

Añade ravitemer/mcphub.nvim a tu configuración de lazy.nvim con opts = { ... }.✓ Copiado

→ :MCPHub abre la interfaz de gestión
Instala un servidor desde el marketplace

:MCPHub marketplace — busca 'github' e instala.✓ Copiado

→ Servidor iniciado, herramientas registradas
Usa a través de Avante

En el chat de Avante, haz una pregunta — Avante recoge las herramientas de MCP.✓ Copiado

→ Llamadas de herramientas visibles en la salida de Avante

Resultado: Herramientas de MCP utilizables dentro de tu editor, sin cambio de contexto.

Errores comunes

Node no está en PATH dentro de Neovim — Usa una ruta absoluta en la configuración o asegúrate de que Neovim hereda tu entorno de shell

Cómo configurar servidores MCP locales del proyecto que se fusionen con la configuración global

👤 Desarrolladores políglotas con herramientas diferentes por proyecto ⏱ ~15 min intermediate

Cuándo usarlo: Un proyecto necesita MCP de Postgres, otro necesita un MCP interno personalizado.

Flujo

Crea .mcphub.json5 en la raíz del proyecto

Define servidores específicos del proyecto en .mcphub.json5.✓ Copiado

→ Los servidores se cargan automáticamente al abrir el proyecto
Verifica la fusión

:MCPHub status — ve qué servidores son globales frente a los del proyecto.✓ Copiado

→ Vista fusionada

Resultado: Conjunto de herramientas conscientes del contexto por proyecto.

Errores comunes

Confirmar secretos en .mcphub.json5 — Usa referencias de variables de entorno, ignora el archivo con gitignore si debe contener tokens

Cómo iterar sobre un servidor MCP personalizado desde Neovim

👤 Autores de servidores MCP ⏱ ~15 min advanced

Cuándo usarlo: Estás construyendo un servidor y quieres una iteración rápida.

Flujo

Habilita el modo de desarrollo

Añade tu servidor con dev=true en la configuración de mcphub.✓ Copiado

→ Recarga en caliente al guardar archivo
Itera

Edita el código del servidor; mcphub lo reinicia transparentemente.✓ Copiado

→ Herramientas actualizadas sin reiniciar Neovim

Resultado: Bucle de desarrollo cerrado dentro de Neovim.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

mcphub-nvim + github

Usa GitHub MCP desde Neovim a través del chat de Avante

Instala GitHub MCP a través del marketplace, luego pide a Avante que muestre los PRs asignados a mí.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
(plugin) :MCPHub	Comandos: status, marketplace, install, logs	Gestiona servidores	gratis
(plugin) marketplace-install	nombre_servidor	Añade rápidamente un MCP verificado	gratis
(integration) Avante/CodeCompanion/CopilotChat tools	Prompts de chat	Uso normal del chat	1 llamada de LLM + llamadas de herramientas

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno (el plugin mismo)
Tokens por llamada: Añade una lista de herramientas a los prompts de Avante/CC
Monetario: Gratis (MIT)
Consejo: Desactiva servidores de marketplace no utilizados — cada uno añade herramientas a tu presupuesto de prompts.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Lo que sea que cada MCP instalado necesite

Almacenamiento de credenciales: Referencias de variables de entorno en la configuración de mcphub

Salida de datos: Por MCP aguas abajo

No conceder nunca: No confirmes .mcphub.json5 con secretos en línea

Las entradas de marketplace son enviadas por la comunidad — verifica el publicador antes de instalar.

Resolución de problemas

Errores comunes y soluciones

mcphub falla al iniciar el subproceso de Node

El PATH de Neovim puede no incluir Node. Configura vim.env.PATH o usa una ruta absoluta.

Verificar: :!which node

Avante no ve las herramientas de MCP

Verifica la versión del adaptador de Avante — las versiones antiguas no admiten MCP. Actualiza.

El marketplace muestra una lista vacía

La red/firewall bloquea la URL del marketplace. Verifica los registros de :MCPHub.

El flujo de OAuth se detiene en el navegador

Copia la URL de los registros de :MCPHub y pega manualmente; la redirección de localhost puede no funcionar desde el contexto de Neovim.

Alternativas

mcphub.nvim vs otros

Alternativa	Cuándo usarla	Contrapartida
CodeCompanion.nvim (native)	Quieres chat de LLM sin gestión de MCP	Sin marketplace, sin flujos de OAuth
VS Code MCP	Prefieres VS Code	No es Neovim

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills