Neovim MCP Server

Neovim MCP Server

Connect AI assistants to Neovim via the Model Context Protocol.

20
Stars
3
Forks
20
Watchers
4
Issues
Neovim MCP Server enables seamless integration between Neovim instances and AI assistants by implementing the Model Context Protocol (MCP). It allows for multi-connection management, supports both stdio and HTTP server transport modes, and provides access to structured diagnostic information via URI schemes. With LSP integration, plugin support, and an extensible tool system, it facilitates advanced interaction with Neovim for context-aware AI workflows.

Key Features

Model Context Protocol (MCP) server implementation
Multi-connection support for multiple Neovim instances
Structured diagnostics and resources via URI schemes
Integrated with Neovim as a plugin
Supports both stdio and HTTP server transport modes
Full Language Server Protocol (LSP) workflow integration
Universal document identification by buffer ID or path
Dynamic and user-extensible tool system (experimental)
Automatic setup for Neovim instances
Development tooling with testing and Nix support

Use Cases

Enabling AI assistants to analyze Neovim diagnostics
Context-aware code suggestions in Neovim
Automated code fixes via LSP actions
Smart retrieval of editor or project context for AI models
Hover text translation and expansion workflows
Connecting multiple Neovim sessions to a single AI service
Custom tool execution within Neovim via structured MCP resources
Remote or local editor integration with AI assistants
Seamless collaboration workflows for Neovim-based teams
Plugin-based extension and automation for developer productivity

README

Neovim MCP Server

codecov GitHub Actions Workflow Status

A Model Context Protocol (MCP) server that provides seamless integration with Neovim instances, enabling AI assistants to interact with your editor through connections and access diagnostic information via structured resources. Supports both stdio and HTTP server transport modes for different integration scenarios.

Features

  • Multi-Connection Support: Manage multiple concurrent Neovim instances
  • LSP Integration: Complete LSP workflow with code actions, hover, and diagnostics
  • Universal Document Identifier: Work with files by buffer ID, relative path, or absolute path
  • MCP Resources: Structured diagnostic data via connection-aware URI schemes
  • Multi-Transport Support: Both stdio and HTTP server transport modes
  • Dynamic Tool System ⚠️ (Experimental): User-extensible custom tools
  • Plugin Integration: Automatic setup through Neovim plugin

Installation

Use Cargo install from crates.io

bash
cargo install nvim-mcp

Using Nix

bash
nix profile install github:linw1995/nvim-mcp#nvim-mcp

From Source

bash
git clone https://github.com/linw1995/nvim-mcp.git && cd nvim-mcp
cargo install --path .

Usage Cases Collection

  • LSP Hover Translation (From #85)
  • Diagnostic Analysis and Code Fixes (From #10)
  • Smart Context Retrieval (From #86)
  • And more in Discussions

Quick Start

1. Setup Neovim Integration

With a plugin manager like lazy.nvim:

lua
return {
    "linw1995/nvim-mcp",
    build = "cargo install --path .",
    opts = {},
}

2. Configure claude or other MCP clients

bash
# Auto-connect to current project Neovim instances (recommended)
claude mcp add -s local nvim -- nvim-mcp --log-file . \
  --log-level debug --connect auto

# Analyze diagnostics in current Neovim instance
claude "analyze @nvim:nvim-diagnostics://"

Documentation

For detailed information, see:

Development

Basic development setup:

bash
# Enter development shell
nix develop .

# Run tests
cargo test -- --show-output

# Build and run
cargo run -- --connect auto

See Development Guide for complete setup instructions, testing procedures, and contribution guidelines.

Star History

Star History Chart

Repository Owner

linw1995
linw1995

User

Repository Details

Language Rust
Default Branch main
Size 631 KB
Contributors 4
License Apache License 2.0
MCP Verified Nov 12, 2025

Programming Languages

Rust
92.61%
Lua
6.13%
Nix
0.97%
Shell
0.29%

Tags

Topics

lsp mcp-server nvim nvim-plugin

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Bifrost

    Bifrost

    VSCode Dev Tools exposed via the Model Context Protocol for AI tool integration.

    Bifrost is a Visual Studio Code extension that launches a Model Context Protocol (MCP) server, enabling external AI coding assistants to access advanced code navigation, analysis, and manipulation features from VSCode. It exposes language server capabilities, symbol search, semantic code analysis, and refactoring tools through MCP-compatible HTTP and SSE endpoints. The extension is designed for seamless integration with AI assistants, supporting multi-project environments and configuration via JSON files.

    • 184
    • MCP
    • biegehydra/BifrostMCP
  • Kanboard MCP Server

    Kanboard MCP Server

    MCP server for seamless AI integration with Kanboard project management.

    Kanboard MCP Server is a Go-based server implementing the Model Context Protocol (MCP) for integrating AI assistants with the Kanboard project management system. It enables users to manage projects, tasks, users, and workflows in Kanboard directly via natural language commands through compatible AI tools. With built-in support for secure authentication and high performance, it facilitates streamlined project operations between Kanboard and AI-powered clients like Cursor or Claude Desktop. The server is configurable and designed for compatibility with MCP standards.

    • 15
    • MCP
    • bivex/kanboard-mcp
  • Webvizio MCP Server

    Webvizio MCP Server

    Bridge between Webvizio feedback and AI coding agents via the Model Context Protocol

    Webvizio MCP Server is a TypeScript-based server implementing the Model Context Protocol to securely and efficiently interface with the Webvizio API. It transforms web page feedback and bug reports into structured, actionable developer tasks, providing AI coding agents with comprehensive task context and data. It offers methods to fetch project and task details, retrieve logs and screenshots, and manage task statuses. The server standardizes communication between Webvizio and AI agent clients, facilitating automated issue resolution.

    • 4
    • MCP
    • Webvizio/mcp
  • Vectorize MCP Server

    Vectorize MCP Server

    MCP server for advanced vector retrieval and text extraction with Vectorize integration.

    Vectorize MCP Server is an implementation of the Model Context Protocol (MCP) that integrates with the Vectorize platform to enable advanced vector retrieval and text extraction. It supports seamless installation and integration within development environments such as VS Code. The server is configurable through environment variables or JSON configuration files and is suitable for use in collaborative and individual workflows requiring vector-based context management for models.

    • 97
    • MCP
    • vectorize-io/vectorize-mcp-server
  • GitHub MCP Server

    GitHub MCP Server

    Connect AI tools directly to GitHub for repository, issue, and workflow management via natural language.

    GitHub MCP Server enables AI tools such as agents, assistants, and chatbots to interact natively with the GitHub platform. It allows these tools to access repositories, analyze code, manage issues and pull requests, and automate workflows using the Model Context Protocol (MCP). The server supports integration with multiple hosts, including VS Code and other popular IDEs, and can operate both remotely and locally. Built for developers seeking to enhance AI-powered development workflows through seamless GitHub context access.

    • 24,418
    • MCP
    • github/github-mcp-server
  • CipherTrust Manager MCP Server

    CipherTrust Manager MCP Server

    Enables AI assistants to access CipherTrust Manager securely via the Model Context Protocol.

    CipherTrust Manager MCP Server provides an implementation of the Model Context Protocol (MCP), offering AI assistants such as Claude and Cursor a unified interface to interact with CipherTrust Manager resources. Communication is facilitated through JSON-RPC over stdin/stdout, enabling key management, CTE client management, user management, and connection management functionalities. The tool is configurable via environment variables and integrates with existing CipherTrust Manager instances using the ksctl CLI for secure resource access.

    • 7
    • MCP
    • sanyambassi/ciphertrust-manager-mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results