Neovim MCP Server

Neovim MCP 服务

一个用于 Neovim、提供基于 LSP 的符号工具的 Model Context Protocol（MCP）服务。此服务使 AI 大模型能够通过 Neovim 的语言服务器协议（LSP）执行符号级代码操作。

功能

符号工具（基于 LSP）

• get_symbols_overview(relative_path, depth) - 获取文件中顶层符号的概览。使用 depth 可包含子级符号（例如，类的方法）。
• find_symbol(name_path_pattern, relative_path, depth) - 按名称路径模式查找符号（例如，"MyClass/my_method"）。
• find_referencing_symbols(name_path, relative_path) - 查找对某个符号的所有引用。
• replace_symbol_body(name_path, relative_path, body) - 替换符号定义的主体。
• insert_after_symbol(name_path, relative_path, body) - 在符号定义后插入内容。
• insert_before_symbol(name_path, relative_path, body) - 在符号定义前插入内容。
• rename_symbol(name_path, relative_path, new_name) - 在整个代码库中重命名符号。
• restart_language_server() - 重启 LSP 服务（适用于 LSP 无响应时）。
• get_lsp_client_info() - 获取有关活动 LSP 客户端的信息。

通用工具

• execute_lua(code) - 在 Neovim 中执行 Lua 代码
• execute_vimscript(code) - 在 Neovim 中执行 Vimscript 代码

安装

先决条件

• Python 3.11+
• uv 包管理器
• 内置 LSP 客户端的 Neovim 0.9+

从源码安装

git clone https://github.com/brianhuster/nvim-mcp-server.git
cd nvim-mcp-server
uv sync

添加到 Neovim 配置

将插件目录添加到 Neovim 运行时路径中：

-- In your init.lua or plugins.lua
vim.opt.runtimepath:append("/path/to/nvim-mcp-server/plugin")

使用方法

启动带 MCP 服务的 Neovim

1. 使用套接字启动 Neovim：

   nvim --listen /tmp/nvim.sock
   

2. 设置 NVIM 环境变量并运行 MCP 服务：

   export NVIM=/tmp/nvim.sock
   uv run nvim-mcp
   

配置 Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "nvim": {
      "command": "uv",
      "args": ["run", "nvim-mcp"],
      "env": {
        "NVIM": "/tmp/nvim.sock"
      }
    }
  }
}

与 Goose 搭配使用

extensions:
  nvim-mcp:
    cmd: uv
    args: ["run", "nvim-mcp"]
    env:
      NVIM: "/tmp/nvim.sock"
    type: stdio

开发

命令

• uv run nvim-mcp - 启动 MCP 服务
• uv run nvim-mcp --version - 显示版本
• uv run ruff check - 运行代码检查
• uv run mypy - 运行类型检查