Antigravity用 NVM MCPサーバー

NVM (Node Version Manager) をラップし、Antigravityエージェントが $PATH 上にNodeやnpmが存在しなくてもNode.jsのバージョンを完全に制御できるようにするMCPサーバーです。

なぜこれが必要なのか

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" を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>` を実行

3つの実行ツールすべてで、オプションの 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