VRMCP服务器
VRM 楷模AI 可以用自然语言控制MCP 服务器。 Claude Desktop 只是用自然语言指示Web 在浏览器中VRM 模型实时运行。
安装,安装
该项目支持两种操作模式:
- 本地模式:在本地环境中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