VRMCP (VRM MCP Server)

VRM モデルを AI が自然言語で制御できる MCP サーバー。 Claude Desktop から自然言語で指示するだけで、Web ブラウザで VRM モデルがリアルタイムに動きます。

セットアップ

このプロジェクトは 2 つの運用モードをサポートしています：

1. ローカルモード: ローカル環境で MCP サーバーを起動（従来の方法）

   • ローカルセットアップガイド

2. リモートモード: Vercel にデプロイして、どこからでもアクセス（推奨）

   • リモートセットアップガイド

     {
       "mcpServers": {
         "vrmcp": {
           "url": "https://vrmcp.up.railway.app/api/mcp/sse",
           "headers": {
             "x-api-key": "your-super-secret-key-12345"
           }
         }
       }
     }
     

使い方

利用可能なツールと使い方をまとめています。

• ツールとユースケース

利用可能なツール

Tool	説明	使用例
list_vrm_files	利用可能な VRM/VRMA ファイル一覧	「どんな VRM がある？」
load_vrm_model	VRM モデル読み込み	「character.vrm を読み込んで」
set_vrm_expression	表情設定	「嬉しい表情にして」
set_vrm_pose	ポーズ設定	「右を向いて」
animate_vrm_bone	ボーン操作	「右手を上げて」
load_vrma_animation	VRMA アニメーション読み込み	「greeting.vrma を読み込んで」
play_vrma_animation	アニメーション再生	「挨拶して」
stop_vrma_animation	アニメーション停止	「止めて」
get_vrm_status	状態取得	「現在の状態は？」

プロジェクト構造

vrm-mcp/
├── src/
│   ├── mcp-server.ts          # MCPサーバー実装（stdio + SSE）
│   ├── redis-client.ts
│   └── gateway.ts             # stdio↔SSEゲートウェイ（Claude Desktop用）
├── api/
│   ├── mcp/
│   │   ├── sse.ts             # MCP SSEエンドポイント
│   │   └── messages.ts        # MCP POSTエンドポイント
│   └── viewer/
│       └── sse.ts             # Viewer SSEエンドポイント
├── public/
│   ├── index.html             # VRMビューア（SSE対応）
│   ├── models/                # VRMモデル配置（デフォルト）
│   └── animations/            # VRMAアニメーション配置（デフォルト）
├── package.json
└── README.md