用途
nvim-mcp 是一个 Model Context Protocol(MCP)服务器,旨在与 Neovim 实例无缝集成,使 AI 助手能够通过连接与编辑器交互,并以结构化资源的形式访问诊断信息。
主要能力
- 多连接支持:管理多个并发的 Neovim 实例。
- LSP 集成:提供完整的 LSP 工作流,包括代码操作、悬停和诊断。
- 通用文档标识符:支持通过缓冲区 ID、相对路径或绝对路径操作文件。
- MCP 资源:通过连接感知的 URI 方案提供结构化诊断数据。
- 多传输支持:同时支持 stdio 和 HTTP 服务器传输模式。
- 动态工具系统(实验性):用户可扩展的自定义工具。
- 插件集成:通过 Neovim 插件自动设置。
使用方式
可通过以下方式安装与运行:
- 使用 Cargo 从 crates.io 安装。
- 该仓库是一个 flake,将服务器暴露为默认包与应用,可直接运行而无需安装任何东西,也可安装到 profile 中。
- 通过代码片段安装 Neovim 插件和服务器二进制文件,并以声明方式注册到 Claude Code,无需 cargo install 构建步骤,也无需手动执行 claude mcp add。
- 该方式会为每个项目注册 nvim MCP 服务器,因此可以跳过下方手动 claude mcp add 步骤。
提示:git 会生成一次性的 Neovim 实例来编辑提交、合并和变基信息。如果这些实例加载了完整配置,它们会各自调用 setup() 并在同一 git 根目录中注册一个额外的 socket。可以通过守卫该调用来确保每个仓库恰好只有一个 socket。
设置 Neovim 集成时可以使用 lazy.nvim 等插件管理器。配置 claude 或其他 MCP 客户端时,可参考使用指南、工具参考(包含全部 26 个 MCP 工具的完整参考)、资源(MCP 资源与 URI 方案)以及开发文档。
基本开发设置与完整开发指南可参见开发文档,其中包含测试流程与贡献指南。
适用场景
- LSP 悬停翻译。
- 诊断分析与代码修复。
- 智能上下文检索。
- 更多用例可在 Discussions 中查看。
限制
资料未提供相关限制信息。