Neovim MCP Server
@brianhuster
About Neovim MCP Server
No overview available yet
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"nvim-mcp-server": {
"command": "uv",
"args": [
"sync"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Neovim MCP Server?
A Model Context Protocol (MCP) server for Neovim that provides LSP-based symbol tools, enabling AI language models to interact with Neovim's Language Server Protocol for symbol-level code operations.
How to use Neovim MCP Server?
Install dependencies (Python 3.11+, uv, Neovim 0.9+), clone the repository, and run uv sync. Start Neovim with nvim --listen /tmp/nvim.sock, set the NVIM environment variable to that socket, then run uv run nvim-mcp. Configure with Claude Desktop or Goose using the provided config examples.
Key features of Neovim MCP Server
- LSP-based symbol tools: overview, find, references, rename
- Symbol body replacement and insertion before/after definitions
- General tools: execute Lua and Vimscript code
- Restart language server and query active LSP clients
Use cases of Neovim MCP Server
- AI-assisted code navigation and symbol discovery
- Automated symbol renaming across the codebase
- Inserting or replacing symbol bodies via AI
- Executing Lua/Vimscript commands from language models
FAQ from Neovim MCP Server
What are the prerequisites?
Python 3.11+, the uv package manager, and Neovim 0.9+ with a built-in LSP client.
How do I start the server?
Start Neovim with a socket (e.g., nvim --listen /tmp/nvim.sock), set NVIM to that socket, then run uv run nvim-mcp.
How can I use it with Claude Desktop?
Add the configuration to claude_desktop_config.json using uv as the command and the NVIM environment variable.
What tools are available?
LSP-based symbol tools (overview, find, references, replace, insert, rename) and general tools (execute Lua/Vimscript, restart LSP, get LSP info).
How do I run linting and type checking?
Use uv run ruff check for linting and uv run mypy for type checking (development commands).
Frequently asked questions
What are the prerequisites?
Python 3.11+, the `uv` package manager, and Neovim 0.9+ with a built-in LSP client.
How do I start the server?
Start Neovim with a socket (e.g., `nvim --listen /tmp/nvim.sock`), set `NVIM` to that socket, then run `uv run nvim-mcp`.
How can I use it with Claude Desktop?
Add the configuration to `claude_desktop_config.json` using `uv` as the command and the `NVIM` environment variable.
What tools are available?
LSP-based symbol tools (overview, find, references, replace, insert, rename) and general tools (execute Lua/Vimscript, restart LSP, get LSP info).
How do I run linting and type checking?
Use `uv run ruff check` for linting and `uv run mypy` for type checking (development commands).
Basic information
More Other MCP servers
ghidraMCP
LaurieWiredMCP Server for Ghidra
MCP Registry
modelcontextprotocolA community driven registry service for Model Context Protocol (MCP) servers.
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
Mobile Mcp
mobile-nextModel Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices)
Comments