mcp-neovim-server

概述

这个 MCP 服务器使 Claude 等 AI 模型能够通过丰富的工具集与 Neovim 交互。它通过套接字文件提供对缓冲区、窗口、搜索操作和 Vim 命令的全面控制，同时保持轻量级连接。服务器提供基本操作如缓冲区编辑和高级功能，如宏录制、标签管理和带有快速修复集成的全局搜索。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• vim_bufferfilename (string, optional)

  Get buffer contents with line numbers (supports filename parameter)

  试试:Show me the contents of the current buffer试试:Display buffer for file src/main.js
• vim_commandcommand (string)

  Send a command to VIM for navigation, spot editing, and line deletion

  试试:Go to line 42 in the current buffer试试:Delete the current line试试:Run the shell command !ls
• vim_status

  Get comprehensive Neovim status including cursor position, mode, and more

  试试:What's the current cursor position and mode?试试:Show me visual selection details
• vim_editstartLine (number), mode ("insert" | "replace" | "replaceAll"), lines (string)

  Edit lines using insert, replace, or replaceAll modes

  试试:Insert new lines at line 10试试:Replace lines starting at line 5 with new text
• vim_windowcommand (string: "split", "vsplit", "only", "close", "wincmd h/j/k/l")

  Manipulate Neovim windows (split, vsplit, close, navigate)

  试试:Split the current window vertically试试:Close the current window试试:Navigate to the left window
• vim_searchpattern (string), ignoreCase (boolean, optional), wholeWord (boolean, optional)

  Search within current buffer with regex support

  试试:Search for 'function' in the buffer试试:Find 'TODO' case-insensitive
• vim_search_replacepattern (string), replacement (string), global (boolean, optional), ignoreCase (boolean, optional), confirm (boolean, optional)

  Find and replace with advanced options

  试试:Replace all instances of 'var' with 'const'试试:Replace old_function with new_function with confirmation
• vim_greppattern (string), filePattern (string, optional)

  Project-wide search using vimgrep with quickfix list

  试试:Search for 'error' in all JS files试试:Find all occurrences of 'FIXME'
• vim_macroaction ("record" | "stop" | "play"), register (string, a-z), count (number, optional)

  Record, stop, and play Vim macros

  试试:Start recording macro in register a试试:Play the macro from register a试试:Stop recording macro
• vim_tabaction ("new" | "close" | "next" | "prev" | "first" | "last" | "list"), filename (string, optional)

  Complete tab management

  试试:Create a new tab试试:Switch to the next tab试试:Close current tab
• vim_foldaction ("create" | "open" | "close" | "toggle" | "openall" | "closeall" | "delete"), startLine/endLine (numbers, for create)

  Code folding operations

  试试:Close all folds in the current buffer试试:Create a fold from line 10 to 15试试:Toggle fold at current position
• vim_health

  Check Neovim connection health and socket status

  试试:Check Neovim connection health试试:Is Neovim socket connected?

可对比工具

安装

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

FAQ

如何启用 shell 命令执行？

在配置中设置环境变量 ALLOW_SHELL_COMMANDS 为 'true'。出于安全考虑，默认情况下这是禁用的。

系统要求是什么？

您需要安装支持套接字的 Neovim、用于 MCP 服务器的 Node.js，以及 Claude Desktop 等 Model Context Protocol 客户端。该服务器基于套接字连接工作，不适用于标准 vim。

Hacker News 讨论

开发者社区最近的相关讨论。

• Show HN: MCP Neovim Server – Tiny AI Text Assistant for Neovim▲ 5💬 1
  帖子 by bigcodegen · 2025-03-31

mcp-neovim-server 对比