NVM MCP-Server für Antigravity

Ein MCP-Server, der NVM (Node Version Manager) kapselt und Antigravity-Agenten die volle Kontrolle über Node.js-Versionen gibt – ohne dass Node oder npm bereits im $PATH vorhanden sein müssen.

Warum existiert dies?

Antigravity-Agenten laufen in einem nicht-interaktiven Subprozess und laden niemals die .zshrc / .bashrc Ihrer Shell. Da NVM Node nur in interaktiven Shells zum $PATH hinzufügt, können Agenten node oder npm nicht finden. Dieser Server lädt nvm.sh direkt vor jedem Befehl und umgeht damit das $PATH-Problem vollständig.

Anforderungen

• Python 3.10+

• NVM installiert unter ~/.nvm (oder setzen Sie NVM_DIR in der Konfiguration)

• pip install mcp (oder pip install -r requirements.txt)

Installation

# 1. Clone / copy this folder somewhere permanent
cp -r nvm-mcp-server ~/.nvm-mcp-server

# 2. Install the one dependency
pip install -r ~/.nvm-mcp-server/requirements.txt
# Or, if you prefer a venv:
python3 -m venv ~/.nvm-mcp-server/.venv
~/.nvm-mcp-server/.venv/bin/pip install mcp

Antigravity-Konfiguration

Öffnen (oder erstellen) Sie ~/.gemini/antigravity/mcp_config.json und fügen Sie Folgendes hinzu:

{
  "mcpServers": {
    "nvm-manager": {
      "command": "python3",
      "args": ["/Users/YOUR_USERNAME/.nvm-mcp-server/nvm_server.py"],
      "env": {
        "NVM_DIR": "/Users/YOUR_USERNAME/.nvm"
      }
    }
  }
}

Venv-Benutzer: Ersetzen Sie "python3" durch den absoluten Pfad zum venv-Python, z. B. "/Users/IHR_BENUTZERNAME/.nvm-mcp-server/.venv/bin/python3".

Starten Sie Antigravity nach dem Speichern der Konfiguration neu. Der nvm-manager-Server erscheint unter MCP-Server.

Verfügbare Werkzeuge

Alle drei Ausführungswerkzeuge akzeptieren ein optionales version-Feld, das die sitzungsaktive Version für diesen einen Aufruf überschreibt, sowie ein optionales cwd-Feld.

Beispiel für einen Agenten-Workflow

Agent: nvm_list           → sees v20.11.0 and v22.3.0 installed
Agent: nvm_use "22"       → session set to Node 22
Agent: npm_run "install"  → runs npm install under Node 22
Agent: node_run "index.js" → runs the script under Node 22

# Need a version that isn't installed yet?
Agent: nvm_install "lts"  → downloads latest LTS
Agent: nvm_use "lts"      → switches to it
Agent: nvm_alias "default" "lts"  → makes it the permanent default

Benutzerdefinierter NVM-Speicherort

Wenn NVM an einem anderen Ort als ~/.nvm installiert ist, setzen Sie NVM_DIR im env-Block der mcp_config.json:

"env": {
  "NVM_DIR": "/opt/homebrew/opt/nvm"
}

Fehlerbehebung