nvim-mcp

MCP-сервер, предоставляющий AI-агентам полноценный доступ к запущенному сеансу Neovim. Подключается через собственный msgpack-RPC сокет Neovim — плагины не требуются.

Работает с Cursor, Claude Code, Codex, OpenCode и любым клиентом, поддерживающим MCP.

Перед подключением агента к Neovim, пожалуйста, ознакомьтесь с разделом Безопасная работа.

Что могут делать агенты

• Видеть то же, что и вы — режим редактора, рабочую директорию, открытые буферы, макет окон, контекст курсора, свертки (folds), выделения, метки и диагностику.

• Редактировать буферы в памяти — поиск и замена или полная перезапись с немедленной обратной связью и полной поддержкой отмены действий. Ничего не записывается на диск, пока вы не сохраните изменения.

• Выполнять любые команды Vim — :w, :e, :vsplit, макросы или что угодно другое, что вы могли бы ввести в командной строке.

• Отправлять нажатия клавиш — перемещение, переход в режим вставки, запуск маппингов.

• Запрашивать диагностику LSP — ошибки, предупреждения и подсказки в одном буфере или во всем сеансе.

• Аннотировать код с помощью подсветки — цветные extmarks, чтобы привлечь ваше внимание к конкретным строкам.

• Работать с несколькими экземплярами — автоматически обнаруживает запущенные сеансы и подключается к нужному. См. несколько экземпляров.

Все, что можете сделать вы в Neovim, может сделать и агент. Подробности см. в полном справочнике инструментов.

Related MCP server: Vigentic MCP

Демонстрации

Быстрый старт

nvim-mcp запускается через uv (рекомендуется) или Nix.

Пользователи Cursor: Плагин для Marketplace находится на рассмотрении — как только он станет доступен, он установит MCP-сервер и правила агента вместе (вы можете перейти к шагу 4). Чтобы активировать правило, начните чат с фразы вроде "Connect to my Neovim instance" — или установите правило на "Always" в Settings → Rules, чтобы применять его при каждом обращении.

1. Установите лаунчер.

   curl -LsSf https://astral.sh/uv/install.sh | sh

   Установите Nix — flakes должны быть включены.

2. Зарегистрируйте MCP-сервер в вашем клиенте. Пример для Cursor (.cursor/mcp.json):

   {
     "mcpServers": {
       "nvim-mcp": {
         "command": "uvx",
         "args": ["nvim-mcp"]
       }
     }
   }

   {
     "mcpServers": {
       "nvim-mcp": {
         "command": "nix",
         "args": ["run", "github:paulburgess1357/nvim-mcp"]
       }
     }
   }

   Для Claude Code, Codex, Claude Desktop, OpenCode и других клиентов см. руководство по настройке.

3. Добавьте правила агента — не пропускайте этот шаг. Без правил у агента есть инструменты, но он не знает, когда и как их использовать, и поведение будет ненадежным. См. руководство по настройке для установки.

4. Запустите Neovim — в большинстве систем Linux он автоматически прослушивает Unix-сокет и обнаруживается nvim-mcp. Если автообнаружение не работает, см. переменные окружения. Запускаете несколько экземпляров? См. несколько экземпляров.

Проверка работоспособности

Откройте файл в 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 недетерминированы, имеют полный доступ к API Neovim, и вам следует исходить из того, что они могут совершать ошибки. Работайте в директории с системой контроля версий.

Требования

• Linux

• Python ≥ 3.10

• Neovim ≥ 0.11 (более старые версии работают с --listen и NVIM_ADDRESS)

Лицензия

MIT — см. LICENSE.