nvim-mcp
一 主控程序 服务器，使AI代理能够一流地访问您正在运行的Neovim会话。它通过Neovim的原生msgpack RPC套接字连接——不需要插件。
适用于Cursor、Claude Code、Codex、OpenCode和任何兼容MCP的客户端。
_在将代理连接到Neovim之前，请阅读 安全工作._
代理人能做什么
- 看看你看到了什么 --编辑器模式、工作目录、打开缓冲区、窗口布局、光标上下文、折叠、选择、标记和诊断。
- 编辑内存中的缓冲区 --查找和替换或完全重写，并提供即时反馈和完全撤消支持。在您保存之前，任何内容都不会触及磁盘。
- 运行任何Vim命令 —
:w,:e,:vsplit、宏，或您可以在命令行中键入的任何其他内容。 - 发送按键 --导航，进入插入模式，触发映射。
- 查询LSP诊断 --一个缓冲区或整个会话中的错误、警告和提示。
- 用高亮标记代码 --彩色标记，以吸引你对特定线条的注意。
- 处理多个实例 --自动发现正在运行的会话并连接到正确的会话。看 多个实例.
你可以在Neovim中做任何事情，代理也可以。看 完整工具参考 了解详情。
演示
Using nvim-mcp across two terminals
Using nvim-mcp with a terminal inside Neovim
Claude and Cursor collaborating in one Neovim instance
Using nvim-mcp in Cursor
Multiple Neovim instances
快速启动
光标用户： A. 市场插件 正在等待审核--一旦可用，它将同时安装MCP服务器和代理规则（您可以跳到步骤4）。要激活该规则，请使用以下内容开始聊天 _“连接到我的Neovim实例”_ --或将规则设置为“始终” 设置→ Rules 将其应用于每一个转折点。
- 安装启动器。
uv
curl -LsSf https://astral.sh/uv/install.sh | shNix
安装 无 --必须启用薄片。
- 注册MCP服务器 与您的客户。光标示例(
.cursor/mcp.json):
With uv
{
"mcpServers": {
"nvim-mcp": {
"command": "uvx",
"args": ["nvim-mcp"]
}
}
}With Nix
{
"mcpServers": {
"nvim-mcp": {
"command": "nix",
"args": ["run", "github:paulburgess1357/nvim-mcp"]
}
}
}有关Claude Code、Codex、Claude Desktop、OpenCode和其他客户端，请参阅 配置指南.
- 添加代理规则——不要跳过此步骤。 没有规则，代理人有工具，但不知道 *何时或如何* 使用它们，行为将不可靠。看 配置指南 用于设置。
验证它是否正常工作
在Neovim中打开一个文件，并将其粘贴到您的AI代理中：
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.安全工作
工具和代理规则旨在使用非破坏性操作——编辑发生在内存中，撤销历史被保留，代理被引导到缓冲区操作。但是LLM是不确定的，可以完全访问Neovim的API，并且您应该假设它们会犯错误。在版本控制的目录中工作。
需求
- 一种计算机操作系统
- Python≥3.10
- ≥0.11（旧版本 一起工作
--listen和NVIM_ADDRESS)
许可证
麻省理工学院——见 许可证.