AI导哈

VRM模型控制服务器

VRMCP是一个通过自然语言控制VRM模型的MCP服务器，支持本地和远程部署，适用于虚拟角色动画控制。

  • by lvncer
  • JavaScript
  • 云端部署
  • 更新于
在 GitHub 查看 lvncer/vrmcp

使用说明

VRMCP服务器

VRM 楷模AI 可以用自然语言控制MCP 服务器。 Claude Desktop 只是用自然语言指示Web 在浏览器中VRM 模型实时运行。

安装，安装

该项目支持两种操作模式：

  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

相关 MCP