Neovim MCP Server

Co dělá „Neovim“ MCP Server?

Neovim MCP Server je most, který propojuje AI asistenty – jako je Claude Desktop nebo jakýkoli klient Model Context Protocol (MCP) – s běžící instancí textového editoru Neovim. Pomocí oficiální JavaScript knihovny neovim/node-client umožňuje AI agentům provádět pokročilé úpravy textu, navigaci v souborech, správu bufferů, spouštění vim příkazů, vyhledávání a další operace přímo v Neovimu. Díky zpřístupnění bohaté sady nástrojů pro základní i pokročilé operace umožňuje tento server vývojářům automatizovat pracovní postupy, využívat AI asistenci při úpravách kódu a efektivně spravovat kódovou základnu – přímo ve svém oblíbeném editoru. Je obzvlášť užitečný pro integraci schopností LLM do životního cyklu vývoje softwaru a proměňuje Neovim v inteligentní, AI rozšířené pracovní prostředí.

Seznam promptů

V poskytnuté dokumentaci nejsou uvedeny žádné konkrétní šablony promptů.

Seznam zdrojů

• nvim://session
  Reprezentuje aktuální sezení textového editoru Neovim; poskytuje kontext o běžícím prostředí.

• nvim://buffers
  Vypíše všechny otevřené buffery v aktuálním sezení Neovim, včetně metadat jako stav úprav, zvýraznění syntaxe a ID oken.

Seznam nástrojů

• vim_buffer
  Načte obsah bufferu s čísly řádků. Lze volitelně filtrovat podle názvu souboru.

• vim_command
  Posílá příkazy do Neovimu pro navigaci, editaci a další operace. Podporuje shell příkazy, pokud je povoleno.

• vim_status
  Poskytuje kompletní status: pozice kurzoru, režim, název souboru, výběr, rozložení oken, pracovní adresář, informace o LSP a další.

• vim_edit
  Upravuje řádky pomocí režimů insert, replace nebo replaceAll.

• vim_window
  Spravuje okna v Neovimu (split, vsplit, zavření, navigace).

• vim_mark
  Nastavuje pojmenované značky na konkrétních pozicích.

• vim_register
  Nastavuje obsah Vim registrů.

• vim_visual
  Vytváří výběry ve vizuálním režimu.

• vim_buffer_switch
  Přepíná mezi buffery podle názvu nebo čísla.

• vim_buffer_save
  Ukládá aktuální buffer nebo ukládá pod zadaným názvem souboru.

• vim_file_open
  Otevírá soubory do nových bufferů.

• vim_search
  Vyhledává v aktuálním bufferu s podporou regexu.

• vim_search_replace
  Najde a nahradí s pokročilými možnostmi.

• vim_grep
  Vyhledávání v rámci projektu pomocí vimgrep s quickfix listem.

• vim_macro
  Nahrává, zastavuje a přehrává Vim makra.

• vim_tab
  Správa záložek (vytvoření, zavření, přepnutí, výpis).

• vim_fold
  Provádí operace skládání kódu.

• vim_jump
  Naviguje v jump listu.

Příklady využití tohoto MCP serveru

• Automatizovaná editace kódu
  AI agenti mohou provádět přesné úpravy, refaktorovat kód či vkládat úryvky přímo v Neovimu, což urychluje vývojový proces.

• Průzkum kódové základny
  Rychlé přepínání bufferů, vyhledávání v souborech a navigace ve velkých projektech s podporou AI, což usnadňuje pochopení legacy kódu nebo zaučení nových vývojářů.

• Automatizace pracovních postupů
  Automatizace opakujících se úloh, jako je formátování, skládání kódu nebo správa záložek a oken, zvyšuje produktivitu a snižuje chybovost.

• Diagnostika chyb a monitoring
  Využijte AI k detekci, zvýraznění a opravě problémů v kódové základně nebo pracovním postupu editoru díky nástrojům pro status a monitoring.

• Pokročilé hledání a nahrazování
  Provádějte složité, projektově široké hledání a nahrazování s podporou regexu a potvrzovacích dotazů, což snižuje manuální práci a zvyšuje přesnost.

Jak jej nastavit

Windsurf

1. Ujistěte se, že máte nainstalovaný Node.js.
2. Otevřete nebo vytvořte svůj konfigurační soubor Windsurf.
3. Přidejte položku Neovim MCP Server do objektu mcpServers:

   "mcpServers": {
     "neovim": {
       "command": "npx",
       "args": ["@bigcodegen/mcp-neovim-server@latest"]
     }
   }
   

4. Uložte konfiguraci a restartujte Windsurf.
5. Ověřte, že se server objevil v seznamu dostupných MCP serverů.

Příklad zabezpečení API klíčů

"mcpServers": {
  "neovim": {
    "command": "npx",
    "args": ["@bigcodegen/mcp-neovim-server@latest"],
    "env": {
      "MY_API_KEY": "${MY_API_KEY}"
    },
    "inputs": {
      "socket": "/tmp/nvim"
    }
  }
}

Claude

1. Ujistěte se, že máte nainstalovaný Node.js.
2. Najděte konfigurační soubor Claude.
3. Vložte Neovim MCP server do sekce mcpServers.

   "mcpServers": {
     "neovim": {
       "command": "npx",
       "args": ["@bigcodegen/mcp-neovim-server@latest"]
     }
   }
   

4. Uložte a restartujte Claude.
5. Zkontrolujte seznam MCP serverů pro Neovim.

Cursor

1. Nainstalujte Node.js, pokud ještě není.
2. Otevřete konfigurační soubor Cursor.
3. Přidejte Neovim MCP Server do mcpServers:

   "mcpServers": {
     "neovim": {
       "command": "npx",
       "args": ["@bigcodegen/mcp-neovim-server@latest"]
     }
   }
   

4. Uložte a restartujte Cursor.
5. Ověřte, že je Neovim MCP Server aktivní.

Cline

1. Ujistěte se, že máte nastavený Node.js.
2. Upravte konfigurační soubor Cline.
3. Přidejte položku Neovim MCP server:

   "mcpServers": {
     "neovim": {
       "command": "npx",
       "args": ["@bigcodegen/mcp-neovim-server@latest"]
     }
   }
   

4. Uložte a restartujte Cline.
5. Ověřte, že je server spuštěn pomocí nástroje.

Poznámka:
Zabezpečte všechny API klíče odkazováním na proměnné prostředí v konfiguraci (blok env), jak je ukázáno ve výše uvedeném příkladu.

Jak tento MCP používat uvnitř flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do vašeho workflow ve FlowHunt začněte přidáním MCP komponenty do vašeho flow a propojením s AI agentem:

Klikněte na komponentu MCP pro otevření konfiguračního panelu. V sekci konfigurace systémového MCP vložte detaily vašeho serveru MCP v tomto JSON formátu:

{
  "neovim": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Po konfiguraci může AI agent používat tento MCP jako nástroj s přístupem ke všem jeho funkcím a možnostem. Nezapomeňte změnit “neovim” na skutečný název vašeho MCP serveru a URL nahraďte adresou vašeho MCP serveru.

Přehled

Náš názor

Tento MCP server je dobře zdokumentovaný, poskytuje komplexní sadu Neovim nástrojů, vystavuje užitečné zdroje a obsahuje jasné instrukce pro nastavení na více platformách. Chybí však explicitní šablony promptů a není zmínka o pokročilých MCP funkcích jako roots či sampling. Celkově jde o robustní a praktickou volbu pro AI automatizaci Neovimu, ale s určitým prostorem pro dotažení protokolové úplnosti.

MCP skóre