NVM MCP Server для Antigravity

MCP-сервер, который оборачивает NVM (Node Version Manager), предоставляя агентам Antigravity полный контроль над версиями Node.js — без необходимости наличия Node или npm в $PATH.

Зачем это нужно

Агенты Antigravity запускаются в неинтерактивном подпроцессе и не считывают файлы .zshrc / .bashrc вашей оболочки. Поскольку NVM добавляет Node в $PATH только в интерактивных оболочках, агенты не могут найти node или npm. Этот сервер считывает nvm.sh непосредственно перед каждой командой, полностью обходя проблему с $PATH.

Требования

• Python 3.10+

• NVM, установленный в ~/.nvm (или укажите NVM_DIR в конфигурации)

• pip install mcp (или pip install -r requirements.txt)

Установка

# 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

Откройте (или создайте) ~/.gemini/antigravity/mcp_config.json и добавьте:

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

Для пользователей Venv: замените "python3" на абсолютный путь к Python в виртуальном окружении, например "/Users/YOUR_USERNAME/.nvm-mcp-server/.venv/bin/python3".

Перезапустите Antigravity после сохранения конфигурации. Сервер nvm-manager появится в разделе MCP Servers.

Доступные инструменты

Все три инструмента запуска принимают необязательное поле version, которое переопределяет активную версию сессии для этого конкретного вызова, и необязательное поле cwd.

Пример рабочего процесса агента

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

Пользовательское расположение NVM

Если NVM установлен не в ~/.nvm, укажите NVM_DIR в блоке env файла mcp_config.json:

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

Устранение неполадок