Awesome MCP › Software Development

bigcodegen/mcp-neovim-server

⭐ 320 TypeScript added to this list on 2025-03-16 repository created 2024-12-22

The mcp-neovim-server project is a proof of concept Model Context Protocol (MCP) server designed to integrate the Neovim text editor with AI clients such as Claude Desktop. This integration enables AI-assisted text editing by leveraging the Model Context Protocol, which facilitates communication between Neovim and AI clients. The server uses the official neovim/node-client JavaScript library to connect to a running Neovim instance via a socket file, allowing it to interact with Neovim's native text editing commands and workflows. This approach creates a lightweight AI text assistance layer that can be used for code editing or general text editing purposes. The server provides a comprehensive set of 19 tools that allow AI clients to interact deeply with Neovim sessions. These tools include capabilities to view and manage buffers, get cursor location and mode, run Vim commands and shell commands (optionally), make edits in various modes (insert, replace, replaceAll), perform search and replace with regex support, and conduct project-wide grep searches with quickfix integration. Additionally, the server supports advanced window management, macro recording and playback, tab management, code folding, jump list navigation, and health monitoring of the Neovim connection. The API exposes resources such as the current Neovim session and the list of open buffers with metadata. The tools are categorized into core tools, enhanced buffer management, search and replace, advanced workflow tools, and system tools. Error handling is robust, with custom error classes for connection errors, command errors, and validation errors, ensuring meaningful error messages are returned in MCP format. The server requires a socket connection to Neovim and may not work well with complex Neovim configurations or plugins. Shell command execution is disabled by default for security reasons but can be enabled via environment variables. Installation can be done via a downloadable DXT package or manual configuration in Claude Desktop. Licensed under the MIT License, this project offers a powerful bridge between Neovim and AI clients for enhanced text editing workflows.

https://github.com/bigcodegen/mcp-neovim-server

ai-assisted-text-editingai-interactionai-text-assistanceanthropicapibuffer-managementclaudeclaude-desktopcode-foldingconnection-diagnosticscursor-locationdxt-packageerror-handlingfoldshealth-monitoringjavascriptjavascript-libraryjump-listjump-list-navigationmacro-recordingmacrosmcpmit-licensemodel-context-protocolmodelcontextprotocolneovimneovim/node-clientproject-wide-grepproof-of-conceptquickfixregexsearch-and-replaceshell-commandssocket-connectiontab-managementtabstext-editingtext-editing-modestext-editor-integrationvim-commandswindow-management