Servidor MCP de NVM para Antigravity

Un servidor MCP que envuelve NVM (Node Version Manager), dando a los agentes de Antigravity control total sobre las versiones de Node.js, sin necesidad de que Node o npm estén ya en $PATH.

Por qué existe esto

Los agentes de Antigravity se ejecutan en un subproceso no interactivo y nunca cargan el archivo .zshrc / .bashrc de tu shell. Debido a que NVM añade Node a $PATH solo en shells interactivos, los agentes no pueden encontrar node o npm. Este servidor carga nvm.sh directamente antes de cada comando, evitando por completo el problema de $PATH.

Requisitos

• Python 3.10+

• NVM instalado en ~/.nvm (o configura NVM_DIR en la configuración)

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

Instalación

# 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

Configuración de Antigravity

Abre (o crea) ~/.gemini/antigravity/mcp_config.json y añade:

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

Usuarios de Venv: reemplaza "python3" con la ruta absoluta al Python del venv, por ejemplo "/Users/TU_NOMBRE_DE_USUARIO/.nvm-mcp-server/.venv/bin/python3".

Reinicia Antigravity después de guardar la configuración. El servidor nvm-manager aparecerá bajo Servidores MCP.

Herramientas disponibles

Las tres herramientas de ejecución aceptan un campo opcional version que anula la versión activa de la sesión para esa llamada, y un campo opcional cwd.

Ejemplo de flujo de trabajo del agente

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

Ubicación personalizada de NVM

Si NVM está instalado en un lugar distinto a ~/.nvm, establece NVM_DIR en el bloque env de mcp_config.json:

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

Solución de problemas