VRChat-MCP-OSC插件

你是否曾经希望AI能够控制虚拟现实中的角色，在VRChat中与你互动、发送消息、做出表情？今天要介绍的开源项目VRChat-MCP-OSC插件，正是为了实现这个目标而设计的。它为AI助手和VRChat之间提供了一个桥梁，通过MCP协议实现虚拟现实环境中AI驱动的头像控制和互动。

项目基本信息

一、项目介绍

VRChat-MCP-OSC插件是一个让AI能够控制VRChat角色的MCP工具。它通过OSC与VRChat通信，允许AI助手控制角色参数和表情、发送消息、响应VR事件。

这个服务器提供了以下工具：

• get_avatar_name：获取当前角色名字
• get_avatar_parameters：列出可用角色参数
• set_avatar_parameter：设置角色参数
• set_emote_parameter：触发角色表情
• move_avatar：控制角色移动方向
• look_direction：控制视线方向
• jump：使角色跳跃
• menu：切换VRChat菜单
• voice：切换语音功能
• send_message：向聊天框发送消息

二、核心优势

AI控制VR角色

让AI在虚拟现实中控制化身。

OSC通信

通过开放声音控制与VRChat通信。

完整控制

支持移动、视线、表情、消息等。

无缝集成

自动检测角色配置。

可配置端口

支持自定义OSC和WebSocket端口。

三、适用场景

虚拟助手

AI在VRChat中扮演助手角色。

互动体验

创建AI驱动的互动虚拟角色。

自动化测试

自动化测试VRChat功能。

娱乐应用

AI控制的虚拟角色表演。

四、安装教程

系统要求

安装步骤

第一步：克隆项目并链接

git clone https://github.com/Krekun/vrchat-mcp-osc
cd vrchat-mcp-osc
npm link

第二步：配置Claude Desktop

找到配置文件，添加：

{
  "mcpServers": {
    "vrchat-mcp-osc": {
      "command": "npx",
      "args": ["vrchat-mcp-osc"]
    }
  }
}

第三步：自定义端口（可选）

{
  "mcpServers": {
    "vrchat-mcp-osc": {
      "command": "npx",
      "args": [
        "vrchat-mcp-osc",
        "--websocket-port", "8765",
        "--osc-send-port", "9000",
        "--osc-receive-port", "9001",
        "--debug"
      ]
    }
  }
}

五、使用示例

示例1：获取角色信息

用户指令：“获取当前角色的名字”

AI会调用get_avatar_name工具。

示例2：控制移动

用户指令：“让角色向前移动”

AI会调用move_avatar工具，指定方向。

示例3：发送消息

用户指令：“在VRChat中发送消息‘Hello from AI’”

AI会调用send_message工具。

示例4：触发表情

用户指令：“让角色做开心表情”

AI会调用set_emote_parameter工具。

示例5：控制视线

用户指令：“让角色看向右边”

AI会调用look_direction工具。

六、命令行选项

七、许可说明

• 非商业用途：MIT许可证
• 商业用途：需要单独的商业许可证

八、常见问题

问题1：VRChat未响应命令

解决方案：确保在VRChat设置中启用了OSC，检查端口匹配。

问题2：服务器无法启动

解决方案：检查Node.js版本（需要18+），使用--debug标志查看详细日志。

问题3：NPX参数问题

解决方案：使用双破折号格式：npx vrchat-mcp-osc -- --debug

问题4：Windows权限问题

解决方案：以管理员权限运行命令提示符。

问题5：角色参数获取失败

解决方案：确认角色有可配置的参数。

九、总结

VRChat-MCP-OSC插件是一个让AI能够控制VRChat角色的MCP工具，通过OSC实现虚拟现实中的互动。

这个项目的最大价值在于：

1. AI控制VR：让AI在VRChat中控制化身
2. 完整控制：移动、视线、表情、消息
3. OSC通信：与VRChat无缝集成
4. 可配置：自定义端口和调试选项
5. MIT许可：非商业用途免费

如果你希望在VRChat中创建AI驱动的角色，VRChat-MCP-OSC插件是一个非常创新的工具。