Сервер Neovim MCP

Подключите Claude Desktop (или любой клиент Model Context Protocol) к Neovim с помощью MCP и официальной библиотеки JavaScript neovim/node-client. Этот сервер использует собственные команды редактирования текста и рабочие процессы Vim, которые Claude уже понимает, для создания легкого кода или универсального слоя текстовой помощи AI.

Функции

• Подключается к вашему экземпляру nvim, если вы открываете файл сокета, например --listen /tmp/nvim , при запуске nvim

• Просмотр текущих буферов

• Получает местоположение курсора, режим, имя файла

• Запускает команды vim и, при необходимости, команды оболочки через vim

• Можно вносить изменения с помощью вставки или замены.

Related MCP server: Claude Code Connector MCP

API

Ресурсы

• nvim://session : Текущий сеанс текстового редактора neovim

• nvim://buffers : Список всех открытых буферов в текущем сеансе Neovim с метаданными, включая измененный статус, синтаксис и идентификаторы окон.

Инструменты

• vim_буфер

  • Текущий буфер текстового редактора VIM с отображаемыми номерами строк

  • Имя входного filename (строка)

  • Имя файла игнорируется, возвращается строка пронумерованных строк с текущим активным содержимым буфера.

• vim_команда

  • Отправка команды в VIM для навигации, точечного редактирования и удаления строк

  • Введите command (строка)

  • Запускает команду vim, предварительно пропущенную через nvim.replaceTermcodes . Несколько команд будут работать, если разделены символами новой строки

  • При ошибке возвращается содержимое 'nvim:errmsg'

• vim_status

  • Получить статус редактора VIM

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

• vim_edit

  • Редактирование строк с помощью вставки, замены или заменыAll в редакторе VIM

  • Ввод startLine (число), mode ( "insert" | "replace" | "replaceAll" ), lines (строка)

  • вставка вставит строки в начальную строку

  • replace заменит строки, начинающиеся с startLine

  • replaceAll заменит все содержимое буфера

• vim_window

  • Управление окнами Neovim (разделение, разделение, закрытие, навигация)

  • command ввода (строка: "split", "vsplit", "only", "close", "wincmd h/j/k/l")

  • Позволяет выполнять операции по управлению окнами

• vim_mark

  • Установите отметку в определенном месте

  • Введите mark (строка: az), line (число), column (число)

  • Устанавливает именованные метки в указанных позициях

• vim_register

  • Установить содержимое регистра

  • Входной register (строка: az или "), content (строка)

  • Управляет содержимым регистра

• vim_visual

  • Сделайте визуальный выбор

  • Введите startLine (число), startColumn (число), endLine (число), endColumn (число)

  • Создает выбор визуального режима

Используя этот простой набор инструментов, Клод может заглянуть в ваш сеанс neovim, чтобы ответить на вопросы, а также внести изменения в буфер.

Ограничения

• Это быстрое доказательство концепции для эксперимента с Model Context Protocol. Используйте на свой страх и риск.

• Может некорректно взаимодействовать с пользовательской конфигурацией neovim!

• Обработка ошибок могла бы быть лучше.

• Иногда Клод не совсем правильно понимает вводимые команды vim.

Конфигурация

Переменные среды

• ALLOW_SHELL_COMMANDS : Установите значение «true», чтобы разрешить выполнение команд оболочки (например !ls ). По умолчанию установлено значение false в целях безопасности.

• NVIM_SOCKET_PATH : Установите путь к вашему сокету Neovim. По умолчанию '/tmp/nvim', если не указано иное.

Использование с 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"
      }
    }
  }
}

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.