Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@VRMCP Make the VRM model smile and wave."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VRM モデルを AI が自然言語で制御できる MCP サーバー。 Claude Desktop から自然言語で指示するだけで、Web ブラウザで VRM モデルがリアルタイムに動きます。
自然言語制御: 「嬉しい表情で手を振って」→ AI が自動的にツールを呼び出し
VRMA アニメーション対応: VRMA ファイルの読み込み・再生（ループ・フェード対応）
柔軟な配置: 環境変数で VRM/VRMA ファイルの場所を自由に設定
Related MCP server: Jarvis MCP
このプロジェクトは 2 つの運用モードをサポートしています：
ローカルモード: ローカル環境で MCP サーバーを起動（従来の方法）
リモートモード: Vercel にデプロイして、どこからでもアクセス（推奨）
以下は、ローカルモードのクイックスタートです。
cd /Users/your-name//vrm-mcp
npm installnpm run build# 好きな場所にディレクトリ作成
mkdir -p ~/Documents/MyVRMs/{models,animations}
# VRM/VRMAファイルを配置
cp your-character.vrm ~/Documents/MyVRMs/models/
cp your-animation.vrma ~/Documents/MyVRMs/animations/# プロジェクト内に配置
cp your-character.vrm public/models/
cp your-animation.vrma public/animations/~/Library/Application Support/Claude/claude_desktop_config.json を編集：
{
"mcpServers": {
"vrm-control": {
"command": "node",
"args": ["/Users/lvncer/GitRepos/vrm-mcp/dist/mcp-server.js"],
"env": {
"VRM_MODELS_DIR": "/Users/lvncer/Documents/MyVRMs/models",
"VRMA_ANIMATIONS_DIR": "/Users/lvncer/Documents/MyVRMs/animations",
"VIEWER_PORT": "3000"
}
}
}
}環境変数を省略した場合: デフォルトで ./public/models/ と ./public/animations/ を使用
Claude Desktop を起動 → 自動的に MCP サーバーが起動します
ブラウザでアクセス: http://localhost:3000
Claude Desktop で指示: 「どんな VRM モデルがある？」
あなた: どんなVRMモデルがある？
Claude: character.vrm、character2.vrm、avatar.vrm があります
あなた: character.vrm を読み込んで
Claude: ✓ VRMモデルを読み込みましたあなた: 嬉しい表情にして
Claude: ✓ 表情 "happy" を強さ 1.0 で設定しましたあなた: どんなアニメーションがある？
Claude: greeting.vrma、wave.vrma、dance.vrma、bow.vrma があります
あなた: 笑顔で挨拶して
Claude:
✓ VRMAアニメーション "greeting" を読み込みました
✓ 表情 "happy" を強さ 1.0 で設定しました
▶ VRMAアニメーション "greeting" を再生しました
あなた: ダンスを繰り返して
Claude: ▶ VRMAアニメーション "dance" を再生しました（ループ）
あなた: 止めて
Claude: ⏹ VRMAアニメーションを停止しましたあなた: 右手を上げて
Claude: ✓ ボーン "rightUpperArm" をアニメーションしましたTool | 説明 | 使用例 |
| 利用可能な VRM/VRMA ファイル一覧 | 「どんな VRM がある？」 |
| VRM モデル読み込み | 「character.vrm を読み込んで」 |
| 表情設定 | 「嬉しい表情にして」 |
| ポーズ設定 | 「右を向いて」 |
| ボーン操作 | 「右手を上げて」 |
| VRMA アニメーション読み込み | 「greeting.vrma を読み込んで」 |
| アニメーション再生 | 「挨拶して」 |
| アニメーション停止 | 「止めて」 |
| 状態取得 | 「現在の状態は？」 |
# サーバーを起動
npm run dev
環境変数 | 説明 | デフォルト値 |
| VRM モデルファイルのディレクトリ |
|
| VRMA アニメーションファイルのディレクトリ |
|
| Web ビューアのポート番号 |
|
環境変数 | 説明 | 必須 |
| API キー（認証用） | ⚠️ |
| 許可するオリジン（CORS、カンマ区切り） | ✅ |
| Upstash Redis の URL（セッション管理） | ⚠️ |
| Upstash Redis のトークン | ⚠️ |
環境変数 | 説明 | 例 |
| リモート MCP サーバー URL |
|
| API キー |
|
This server cannot be deployed
Give your AI a face, a voice, and a personality. 3D avatars with custom personas.
Turn text or an image into an animation-ready 3D model (GLB): generate, rig, animate, retexture.
Free text/image → 3D: generate, rig, avatar-ify, and refine GLB models. No auth, no payment.
3D avatars, embeds, glTF tools, agent memory, and on-chain agent identity from three.ws.
