VRMCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
VRMCP (VRM MCP Server)
VRM モデルを AI が自然言語で制御できる MCP サーバー。 Claude Desktop から自然言語で指示するだけで、Web ブラウザで VRM モデルがリアルタイムに動きます。
特徴
自然言語制御: 「嬉しい表情で手を振って」→ AI が自動的にツールを呼び出し
VRMA アニメーション対応: VRMA ファイルの読み込み・再生(ループ・フェード対応)
柔軟な配置: 環境変数で VRM/VRMA ファイルの場所を自由に設定
Related MCP server: Jarvis MCP
セットアップ
セットアップ方法の選択
このプロジェクトは 2 つの運用モードをサポートしています:
ローカルモード: ローカル環境で MCP サーバーを起動(従来の方法)
リモートモード: Vercel にデプロイして、どこからでもアクセス(推奨)
以下は、ローカルモードのクイックスタートです。
1. インストール
cd /Users/your-name//vrm-mcp
npm install2. ビルド
npm run build3. VRM/VRMA ファイルの配置
方法 A: 環境変数で好きな場所を指定(推奨)
# 好きな場所にディレクトリ作成
mkdir -p ~/Documents/MyVRMs/{models,animations}
# VRM/VRMAファイルを配置
cp your-character.vrm ~/Documents/MyVRMs/models/
cp your-animation.vrma ~/Documents/MyVRMs/animations/方法 B: プロジェクト内に配置(デフォルト)
# プロジェクト内に配置
cp your-character.vrm public/models/
cp your-animation.vrma public/animations/4. Claude Desktop 設定
~/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/ を使用
5. 起動
Claude Desktop を起動 → 自動的に MCP サーバーが起動します
ブラウザでアクセス: http://localhost:3000
Claude Desktop で指示: 「どんな VRM モデルがある?」
📖 使い方
VRM モデルの読み込み
あなた: どんなVRMモデルがある?
Claude: character.vrm、character2.vrm、avatar.vrm があります
あなた: character.vrm を読み込んで
Claude: ✓ VRMモデルを読み込みました表情制御
あなた: 嬉しい表情にして
Claude: ✓ 表情 "happy" を強さ 1.0 で設定しましたVRMA アニメーション
あなた: どんなアニメーションがある?
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 を読み込んで」 |
| アニメーション再生 | 「挨拶して」 |
| アニメーション停止 | 「止めて」 |
| 状態取得 | 「現在の状態は?」 |
プロジェクト構造
ローカルでの SSE 接続テスト
# サーバーを起動
npm run dev
環境変数
ローカル開発用
環境変数 | 説明 | デフォルト値 |
| VRM モデルファイルのディレクトリ |
|
| VRMA アニメーションファイルのディレクトリ |
|
| Web ビューアのポート番号 |
|
リモート運用用(Railway/Render 等)
環境変数 | 説明 | 必須 |
| API キー(認証用) | ⚠️ |
| 許可するオリジン(CORS、カンマ区切り) | ✅ |
| Upstash Redis の URL(セッション管理) | ⚠️ |
| Upstash Redis のトークン | ⚠️ |
ゲートウェイ用(Claude Desktop 連携)
環境変数 | 説明 | 例 |
| リモート MCP サーバー URL |
|
| API キー |
|
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Give your AI a face, a voice, and a personality. 3D avatars with custom personas.
Intimate voice AI: 29 voices, 22 languages, emoji vocal cues, multi-voice scenes.
Turn text or an image into an animation-ready 3D model (GLB): generate, rig, animate, retexture.
Build real-time AI avatar personas and videos; manage voices, knowledge, sessions and meetings.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to control and manipulate live 3D scenes across frameworks like Three.js, A-Frame, and Babylon.js using a comprehensive set of object and environment tools. It features an integrated in-world chat system that allows for real-time scene modifications directly from within the 3D canvas.3315 npm3MIT
- AlicenseAqualityDmaintenanceEnables voice conversations with AI assistants directly in the browser, supporting 30+ languages and remote access from any device.531 npm93MIT
- AlicenseBqualityBmaintenanceEnables AI assistants to control Blender 3D software through natural language, with tools for modeling, materials, animation, rendering, and rigging.3819MIT
- AlicenseAqualityDmaintenanceEnables AI to control VRM 3D models through natural language, supporting model loading, expression changes, pose adjustments, and animation playback.9MIT