VRMCP (VRM MCP Server)

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

セットアップ

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

ローカルモード: ローカル環境で MCP サーバーを起動（従来の方法）
- ローカルセットアップガイド

リモートモード: 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

vrmcp

VRMCP (VRM MCP Server)

セットアップ

使い方

利用可能なツール

プロジェクト構造

Latest Blog Posts

MCP directory API