mcp-neovim-server

Сервер Neovim MCP

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

Функции

• Подключается к вашему экземпляру nvim, если вы открываете файл сокета, например --listen /tmp/nvim , при запуске nvim
• Просмотр текущих буферов
• Получает местоположение курсора, режим, имя файла
• Запускает команды vim и, при необходимости, команды оболочки через vim
• Можно вносить изменения с помощью вставки или замены.

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 :

Лицензия

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