Servidor MCP de Neovim

Una prueba de concepto de integración entre Claude Desktop (o cualquier cliente) y Neovim mediante el Protocolo de Contexto de Modelo (MCP) y la biblioteca JavaScript oficial de neovim/node-client. Este servidor aprovecha los comandos y flujos de trabajo de edición de texto nativos de Vim, que Claude ya comprende, para crear un código ligero o una capa de asistencia de texto de IA de propósito general.

Características

• Se conecta a su instancia nvim si expone un archivo de socket, por ejemplo --listen /tmp/nvim , al iniciar nvim

• Visualiza tus buffers actuales

• Obtiene la ubicación del cursor, el modo y el nombre del archivo.

• Ejecuta comandos vim y, opcionalmente, comandos de shell a través de vim

• Puede realizar ediciones utilizando insertar o reemplazar

API

Recursos

• nvim://session : Sesión actual del editor de texto neovim

• nvim://buffers : lista de todos los buffers abiertos en la sesión actual de Neovim con metadatos que incluyen estado modificado, sintaxis e identificaciones de ventana

Herramientas

• búfer de vim

  • Buffer del editor de texto VIM actual con números de línea mostrados

  • filename de entrada (cadena)

  • Se ignora el nombre del archivo y se devuelve una cadena de líneas numeradas con el contenido del búfer activo actual

• comando vim

  • Envíe un comando a VIM para navegación, edición puntual y eliminación de líneas

  • command de entrada (cadena)

  • Ejecuta un comando de VIM que primero se pasa por nvim.replaceTermcodes . Varios comandos funcionarán si se separan con saltos de línea.

  • En caso de error, se devuelve el contenido 'nvim:errmsg'

• estado de vim

  • Obtener el estado del editor VIM

  • El estado contiene la posición del cursor, el modo, el nombre del archivo, la selección visual, el diseño de la ventana, la pestaña actual, las marcas, los registros y el directorio de trabajo.

• vim_edit

  • Editar líneas usando insertar, reemplazar o reemplazar todo en el editor de VIM

  • Entrada startLine (número), mode ( "insert" | "replace" | "replaceAll" ), lines (cadena)

  • Insertar insertará líneas en la línea de inicio

  • replace reemplazará las líneas comenzando en startLine

  • replaceAll reemplazará todo el contenido del buffer

• ventana_vim

  • Manipular ventanas de Neovim (dividir, vsplit, cerrar, navegar)

  • command de entrada (cadena: "split", "vsplit", "only", "close", "wincmd h/j/k/l")

  • Permite operaciones de gestión de ventanas

• marca_vim

  • Establecer una marca en una posición específica

  • mark de entrada (cadena: az), line (número), column (número)

  • Establece marcas con nombre en posiciones específicas

• registro_vim

  • Establecer el contenido de un registro

  • register de entrada (cadena: az o "), content (cadena)

  • Gestiona el contenido del registro

• vim_visual

  • Hacer una selección visual

  • Entrada startLine (número), startColumn (número), endLine (número), endColumn (número)

  • Crea selecciones de modo visual

Con este sencillo conjunto de herramientas, Claude puede examinar su sesión de neovim para responder preguntas y realizar modificaciones en el buffer.

Limitaciones

• Esta es una prueba de concepto rápida para experimentar con el Protocolo de Contexto de Modelo. Úselo bajo su propia responsabilidad.

• ¡Puede que no interactúe bien con una configuración de neovim personalizada!

• El manejo de errores podría ser mejor.

• A veces Claude no obtiene la entrada del comando vim correctamente.

Configuración

Variables de entorno

• ALLOW_SHELL_COMMANDS : Establézcalo como 'true' para habilitar la ejecución de comandos de shell (p. ej. !ls ). El valor predeterminado es 'false' por seguridad.

• NVIM_SOCKET_PATH : Establezca la ruta de su socket de Neovim. El valor predeterminado es '/tmp/nvim' si no se especifica.

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.