Antigravity용 NVM MCP 서버

NVM (Node Version Manager)을 래핑하여 Antigravity 에이전트가 $PATH에 Node나 npm이 미리 설치되어 있지 않아도 Node.js 버전을 완전히 제어할 수 있게 해주는 MCP 서버입니다.

이 서버가 필요한 이유

Antigravity 에이전트는 비대화형 하위 프로세스에서 실행되며 셸의 .zshrc / .bashrc를 소싱하지 않습니다. NVM은 대화형 셸에서만 $PATH에 Node를 추가하기 때문에 에이전트는 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"을 venv Python의 절대 경로로 바꾸세요. 예: "/Users/YOUR_USERNAME/.nvm-mcp-server/.venv/bin/python3".

설정을 저장한 후 Antigravity를 다시 시작하세요. MCP 서버 아래에 nvm-manager 서버가 나타납니다.

사용 가능한 도구

도구	기능
`nvm_list`	로컬에 설치된 모든 Node 버전 나열
`nvm_list_remote`	설치 가능한 버전 나열 (필터 허용: `'lts'`, `'22'` 등)
`nvm_install`	버전 다운로드 및 설치 (`'22'`, `'lts'`, `'lts/iron'`, `'20.11.0'`)
`nvm_use`	세션 활성 버전 전환 — 이후 모든 호출에 대해 유지됨
`nvm_current`	현재 세션에서 활성화된 버전 표시
`nvm_alias`	NVM 별칭 설정 (예: `default`를 새 버전에 지정)
`node_run`	활성(또는 지정된) 버전으로 `node <args>` 실행
`npm_run`	활성(또는 지정된) 버전으로 `npm <args>` 실행
`npx_run`	활성(또는 지정된) 버전으로 `npx <args>` 실행

세 가지 실행 도구 모두 해당 호출에 대해서만 세션 활성 버전을 재정의하는 선택적 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 이외의 위치에 설치된 경우 mcp_config.json의 env 블록에 NVM_DIR을 설정하세요:

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

문제 해결

증상	해결 방법
`nvm.sh not found`	`env` 블록의 `NVM_DIR`이 NVM 루트를 가리키는지 확인하세요
`nvm_install` 시간 초과	`nvm_server.py`의 하위 프로세스 시간 제한을 늘리세요 (기본값 300초)
버전을 찾을 수 없음	`nvm_list_remote`를 실행하여 정확한 버전 문자열을 확인하세요
서버가 나타나지 않음	Antigravity → `...` → MCP 서버에서 오류 메시지를 확인하세요

NVM MCP Server

Antigravity용 NVM MCP 서버

이 서버가 필요한 이유

요구 사항

설치

Antigravity 설정

사용 가능한 도구

에이전트 워크플로우 예시

사용자 지정 NVM 위치

문제 해결

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API