nvim-mcp

Ein MCP-Server, der KI-Agenten erstklassigen Zugriff auf deine laufende Neovim-Sitzung gewährt. Er verbindet sich über Neovims nativen msgpack-RPC-Socket – es sind keine Plugins erforderlich.

Funktioniert mit Cursor, Claude Code, Codex, OpenCode und jedem MCP-kompatiblen Client.

Bevor du einen Agenten mit Neovim verbindest, lies bitte Sicheres Arbeiten.

Was Agenten tun können

• Sehen, was du siehst – Editormodus, Arbeitsverzeichnis, geöffnete Puffer, Fensterlayout, Cursor-Kontext, Folds, Markierungen, Marks und Diagnosen.

• Puffer im Arbeitsspeicher bearbeiten – Suchen-und-Ersetzen oder vollständiges Umschreiben mit sofortigem Feedback und vollständiger Unterstützung für Rückgängigmachen. Nichts wird auf die Festplatte geschrieben, bevor du speicherst.

• Jeden Vim-Befehl ausführen – :w, :e, :vsplit, Makros oder alles andere, was du in der Befehlszeile eingeben könntest.

• Tastatureingaben senden – Navigieren, in den Einfügemodus wechseln, Mappings auslösen.

• LSP-Diagnosen abfragen – Fehler, Warnungen und Hinweise für einen Puffer oder die gesamte Sitzung.

• Code mit Hervorhebungen annotieren – farbige Extmarks, um deine Aufmerksamkeit auf bestimmte Zeilen zu lenken.

• Mit mehreren Instanzen arbeiten – erkennt automatisch laufende Sitzungen und verbindet sich mit der richtigen. Siehe mehrere Instanzen.

Alles, was du in Neovim tun kannst, kann auch der Agent. Siehe die vollständige Tool-Referenz für Details.

Related MCP server: Vigentic MCP

Demos

Schnelleinstieg

nvim-mcp läuft über uv (empfohlen) oder Nix.

Cursor-Benutzer: Ein Marketplace-Plugin wird derzeit geprüft – sobald es verfügbar ist, installiert es den MCP-Server und die Agentenregel zusammen (du kannst zu Schritt 4 springen). Um die Regel zu aktivieren, starte Chats mit etwas wie "Connect to my Neovim instance" – oder setze die Regel in Settings → Rules auf "Always", damit sie bei jeder Anfrage angewendet wird.

1. Installiere einen Launcher.

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

   Installiere Nix – Flakes müssen aktiviert sein.

2. Registriere den MCP-Server bei deinem Client. Beispiel für Cursor (.cursor/mcp.json):

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

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

   Für Claude Code, Codex, Claude Desktop, OpenCode und andere Clients siehe den Konfigurationsleitfaden.

3. Füge Agentenregeln hinzu – überspringe diesen Schritt nicht. Ohne Regeln hat der Agent zwar die Werkzeuge, weiß aber nicht, wann oder wie er sie einsetzen soll, und das Verhalten wird unzuverlässig sein. Siehe den Konfigurationsleitfaden für die Einrichtung.

4. Starte Neovim – auf den meisten Linux-Systemen lauscht es automatisch auf einem Unix-Socket und wird von nvim-mcp erkannt. Wenn die automatische Erkennung nicht funktioniert, siehe Umgebungsvariablen. Lässt du mehrere Instanzen laufen? Siehe mehrere Instanzen.

Überprüfen, ob es funktioniert

Öffne eine Datei in Neovim und füge dies in deinen KI-Agenten ein:

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.

Sicheres Arbeiten

Die Werkzeuge und Agentenregeln sind so konzipiert, dass sie nicht-destruktive Operationen verwenden – Bearbeitungen finden im Arbeitsspeicher statt, die Rückgängig-Historie bleibt erhalten und der Agent wird auf Pufferoperationen gelenkt. Aber LLMs sind nicht-deterministisch, haben vollen Zugriff auf die Neovim-API, und du solltest davon ausgehen, dass sie Fehler machen werden. Arbeite in einem versionskontrollierten Verzeichnis.

Anforderungen

• Linux

• Python ≥ 3.10

• Neovim ≥ 0.11 (ältere Versionen funktionieren mit --listen und NVIM_ADDRESS)

Lizenz

MIT – siehe LICENSE.