Neovim MCP Server

Neovim MCP Server

使用模型上下文协议（MCP）和官方的neovim/node-client JavaScript库来控制Neovim。

GitHub
Created Bybigcodegenbigcodegen

mcp-neovim-server MCP 服务器

概述

Neovim MCP 服务器通过模型上下文协议（MCP）实现 Claude Desktop 与 Neovim 的集成，让 AI 助手可以与您的编辑器会话交互。

安装与设置

  1. 确保已安装 Neovim 并暴露套接字文件

    nvim --listen /tmp/nvim

  2. 配置 Claude Desktop，编辑 claude_desktop_config.json：

    {
  "mcpServers": {
    "MCP Neovim Server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-neovim-server"
      ],
      "env": {
        "ALLOW_SHELL_COMMANDS": "true",
        "NVIM_SOCKET_PATH": "/tmp/nvim"
      }
    }
  }
}

主要功能

  • 🔄 查看当前缓冲区及状态
  • 📍 获取光标位置、模式、文件名
  • 🛠️ 执行 Vim 命令和 shell 命令
  • ✏️ 编辑文本（插入、替换、全部替换）
  • 🪟 管理窗口（分割、导航）

核心工具

工具功能输入参数
vim_buffer显示当前缓冲区filename (忽略)
vim_command执行 Vim 命令command (字符串)
vim_status获取编辑器状态无
vim_edit编辑文本startLine, mode, lines
vim_window窗口操作command

环境变量

  • ALLOW_SHELL_COMMANDS: 设置为 true 启用 shell 命令
  • NVIM_SOCKET_PATH: Neovim 套接字路径，默认为 /tmp/nvim

注意事项

  • 概念验证项目，使用时请自行承担风险
  • 可能与自定义 Neovim 配置不兼容
  • 发布于 MIT 许可证下

更多详细信息请参见完整文档。