nvim-mcp
MCP-сервер, который дает агентам доступ к вашей запущенной сессии Neovim через родной сокет msgpack-RPC, без плагинов.
- 67 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент получает полный доступ к запущенной сессии Neovim и может выполнять любые команды Vim и нажатия клавиш.
- Правки идут в буферы редактора и попадают на диск при сохранении.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/nvim-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает полный доступ к запущенной сессии Neovim и может выполнять любые команды Vim и нажатия клавиш.
- Правки идут в буферы редактора и попадают на диск при сохранении.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
nvim-mcp подключает агента к работающему Neovim. Агент видит то же, что и вы: режим редактора, рабочий каталог, открытые буферы, раскладку окон, контекст курсора, выделения, метки и диагностику. Правки идут в буферы в памяти с полной историей отмены, на диск ничего не попадает до сохранения. Агент может выполнять любые команды Vim (`:w`, `:e`, `:vsplit`, макросы), отправлять нажатия клавиш, запрашивать диагностику LSP по буферу или сессии и размечать код цветными подсветками и виртуальным текстом, не меняя содержимое буфера. Сервер находит запущенные экземпляры сам и подключается к нужному. Работает с Cursor, Claude Code, Codex, OpenCode и любым клиентом MCP.
Для кого. Пользователям Neovim, которые хотят работать с агентом прямо в своем редакторе и видеть его правки в буфере.
Подходит, если
- Буферы, выделение и диагностика LSP читаются без копирования кода в чат.
- Результат работы агента видно в буфере и проверяют до сохранения.
- Несколько экземпляров Neovim работают одновременно, и нужно выбрать подходящий.
- Найденные проблемы отмечаются подсветкой и подсказками прямо в коде.
Не подходит, если
- Нужна Windows или Neovim старше 0.11 без дополнительной настройки: основная цель Linux и Neovim 0.11 и новее.
- Нужны только правки файлов на диске без участия редактора.
- Нужен узкий набор операций: инструмент отдает агенту любые команды Vim.
Пример запроса к агенту
Прочитай диагностику LSP открытого буфера и исправь первую ошибку прямо в буфере, не сохраняя файл.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
NVIM_ADDRESS- Адрес сокета Neovim для версий, где автоопределение не работает.
Ограничения
Сервер рассчитан на Linux, Python 3.10 и новее, Neovim 0.11 и новее (старые версии работают с `--listen` и переменной `NVIM_ADDRESS`). Без файла правил для агента инструменты есть, но агент не знает, когда и как ими пользоваться: поставьте правила из `config/AGENTS-EXAMPLE.md`. Агент получает полный доступ к сессии Neovim и может выполнять любые команды Vim, поэтому перед подключением прочитайте раздел Working safely.
Как отключить. Удалите запись `nvim-mcp` из MCP-конфигурации клиента и добавленные правила для агента.
Частые вопросы
Как подключить nvim-mcp?
Добавьте в MCP-конфигурацию сервер с командой `uvx` и аргументом `nvim-mcp`, либо через Nix командой `nix run github:paulburgess1357/nvim-mcp`.
Нужен ли плагин для Neovim?
Нет. Сервер подключается через родной сокет msgpack-RPC.
Почему нужны правила для агента?
Без них у агента есть инструменты, но нет понимания, когда и как их применять, и поведение нестабильно.
Что с несколькими экземплярами Neovim?
Сервер находит запущенные сессии сам и подключается к нужной. Подробности в `docs/MULTIPLE_INSTANCES.md`.
Попадают ли правки на диск сразу?
Нет, до сохранения файл на диске остается прежним.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыCodeCompanion.nvim
codecompanion.nvim
AI-ассистент для Neovim с чатом по LLM и запуском Claude Code, Codex, Gemini CLI прямо в редакторе через ACP и MCP
MCP-сервер, который дает агенту читать файлы, искать по коду и запускать команды в рабочей папке
nimlangserver работает MCP-сервером для Nim: агент ищет символы и ссылки, проверяет файлы и узнает типы по данным компилятора
add-mcp одной командой прописывает MCP-сервер в конфигурации 25 агентов: Claude Code, Codex, Cursor, VS Code, Zed и других
Расширение VS Code поднимает локальный MCP-сервер: агент ищет символы, правит файлы и запускает команды в терминале редактора
CLI openmcp и расширение VS Code для отладки MCP-серверов: проверка инструментов, промптов и ресурсов, чат с моделью, тесты
Коротко о README
Сервер запускается через `uvx` или Nix, в репозитории есть полное описание инструментов, конфигурации для нескольких клиентов, правила для Cursor и плагин для маркетплейса Cursor.