nvim-mcp

Un servidor MCP que proporciona a los agentes de IA acceso de primera clase a tu sesión de Neovim en ejecución. Se conecta a través del socket nativo msgpack-RPC de Neovim; no requiere plugins.

Funciona con Cursor, Claude Code, Codex, OpenCode y cualquier cliente compatible con MCP.

Antes de conectar un agente a Neovim, por favor lee Trabajar de forma segura.

Qué pueden hacer los agentes

• Ver lo que tú ves — modo de editor, directorio de trabajo, buffers abiertos, diseño de ventanas, contexto del cursor, pliegues, selecciones, marcas y diagnósticos.

• Editar buffers en memoria — buscar y reemplazar o reescrituras completas con retroalimentación inmediata y soporte completo de deshacer. Nada toca el disco hasta que guardas.

• Ejecutar cualquier comando de Vim — :w, :e, :vsplit, macros o cualquier otra cosa que pudieras escribir en la línea de comandos.

• Enviar pulsaciones de teclas — navegar, entrar en modo insertar, activar mapeos.

• Consultar diagnósticos LSP — errores, advertencias y sugerencias en un buffer o en toda la sesión.

• Anotar código con resaltados — extmarks de colores para llamar tu atención sobre líneas específicas.

• Trabajar con múltiples instancias — descubre automáticamente las sesiones en ejecución y se conecta a la correcta. Consulta múltiples instancias.

Cualquier cosa que puedas hacer en Neovim, el agente también puede. Consulta la referencia completa de herramientas para más detalles.

Related MCP server: Vigentic MCP

Demos

Inicio rápido

nvim-mcp se ejecuta a través de uv (recomendado) o Nix.

Usuarios de Cursor: Un plugin de Marketplace está pendiente de revisión; una vez disponible, instalará el servidor MCP y la regla del agente juntos (puedes saltar al paso 4). Para activar la regla, inicia chats con algo como "Connect to my Neovim instance" — o establece la regla en "Always" en Settings → Rules para aplicarla en cada turno.

1. Instala un lanzador.

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

   Instala Nix — los flakes deben estar habilitados.

2. Registra el servidor MCP con tu cliente. Ejemplo para Cursor (.cursor/mcp.json):

   {
     "mcpServers": {
       "nvim-mcp": {
         "command": "uvx",
         "args": ["nvim-mcp"]
       }
     }
   }

   {
     "mcpServers": {
       "nvim-mcp": {
         "command": "nix",
         "args": ["run", "github:paulburgess1357/nvim-mcp"]
       }
     }
   }

   Para Claude Code, Codex, Claude Desktop, OpenCode y otros clientes, consulta la guía de configuración.

3. Añade reglas de agente — no te saltes esto. Sin reglas, el agente tiene las herramientas pero no sabe cuándo o cómo usarlas, y el comportamiento será poco fiable. Consulta la guía de configuración para la configuración.

4. Inicia Neovim — en la mayoría de los sistemas Linux escucha en un socket Unix automáticamente y es descubierto por nvim-mcp. Si el descubrimiento automático no funciona, consulta las variables de entorno. ¿Ejecutas múltiples instancias? Consulta múltiples instancias.

Verifica que funciona

Abre un archivo en Neovim y pega esto en tu agente de IA:

For each step: explain what you're about to do, then do it, then tell me
what happened. Wait for me to say "next" before moving on.

1. What file am I in? Highlight the function my cursor is in.
2. Are there any diagnostics? Highlight any lines with errors or warnings.
3. Add a docstring above the function, then show me the diff.
4. Open a vertical split, write a short test for that function, and save both files.

Trabajar de forma segura

Las herramientas y las reglas del agente están diseñadas para usar operaciones no destructivas: las ediciones ocurren en memoria, el historial de deshacer se conserva y el agente es dirigido hacia operaciones de buffer. Pero los LLM no son deterministas, tienen acceso completo a la API de Neovim y debes asumir que cometerán errores. Trabaja en un directorio con control de versiones.

Requisitos

• Linux

• Python ≥ 3.10

• Neovim ≥ 0.11 (versiones anteriores funcionan con --listen y NVIM_ADDRESS)

Licencia

MIT — consulta LICENSE.