Skip to main content
Glama

OSC de MCP de VRChat

VRChat MCP OSC proporciona un puente entre los asistentes de IA y VRChat mediante el Protocolo de contexto de modelo (MCP), lo que permite el control de avatares e interacciones impulsadas por IA en entornos de realidad virtual.

Descripción general

Al aprovechar OSC (Open Sound Control) para comunicarse con VRChat, VRChat MCP OSC permite a los asistentes de IA como Claude:

  • Controlar los parámetros y expresiones del avatar

  • Enviar mensajes en VRChat

  • Responder a diversos eventos de realidad virtual
    Y mucho más, todo a través de la API de alto nivel proporcionada por el Protocolo de Contexto de Modelo.

Related MCP server: Blender MCP

Características principales

  • Control de avatar : manipule los parámetros y expresiones del avatar

  • Control de movimiento : movimiento y orientación directos del avatar

  • Comunicación : Envía mensajes a través del chatbox de VRChat

  • Acceso al menú : alternar entre el menú y los elementos de la interfaz de VRChat

  • Información del avatar : Consultar propiedades y parámetros del avatar

  • Integración perfecta con VRChat : detección automática de configuraciones de avatar

Requisitos del sistema

  • Node.js 18 o superior

  • VRChat con OSC habilitado

  • Claude Desktop (con soporte MCP)

Uso con Claude Desktop

Clonar y vincular npm

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

Configurar Claude Desktop

Configure Claude Desktop editando el archivo claude_desktop_config.json :

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

Opciones de línea de comandos

El servidor admite varios argumentos de línea de comandos para la personalización:

# Claude Desktop configuration
{
  "mcpServers": {
    "vrchat-mcp-osc": {
      "command": "npx",
      "args": [
        "vrchat-mcp-osc",
        "--websocket-port", "8765",
        "--websocket-host", "localhost",
        "--osc-send-port", "9000",
        "--osc-send-ip", "127.0.0.1",
        "--osc-receive-port", "9001",
        "--osc-receive-ip", "127.0.0.1",
        "--debug"             
      ]
    }
  }
}

Opciones disponibles

Opción

Descripción

Por defecto

Notas

--websocket-port <port>

Puerto WebSocket

8765

Para la comunicación WebSocket

--websocket-host <host>

Host de WebSocket

host local

Para la comunicación WebSocket

--osc-send-port <port>

Puerto de envío OSC

9000

Puerto para enviar a VRChat

--osc-send-ip <ip>

OSC envía IP

127.0.0.1

Dirección para enviar a VRChat

--osc-receive-port <port>

Puerto de recepción OSC

9001

Puerto para recibir desde VRChat

--osc-receive-ip <ip>

OSC recibe IP

127.0.0.1

Dirección para recibir de VRChat

--debug

Habilitar el registro de depuración

FALSO

Generar registros detallados

--no-relay

Deshabilitar el servidor de retransmisión

FALSO

Cuando no se utiliza el servidor de retransmisión

Herramientas MCP disponibles

VRChat MCP OSC expone las siguientes herramientas MCP a los asistentes de IA:

Nombre de la herramienta

Descripción

get_avatar_name

Recupera el nombre del avatar actual

get_avatar_parameters

Enumera los parámetros de avatar disponibles

set_avatar_parameter

Establece un parámetro de avatar específico

set_emote_parameter

Activa los gestos del avatar

move_avatar

Mueve el avatar en una dirección específica.

look_direction

Controla la dirección de la vista del avatar.

jump

Hace que el avatar salte

menu

Activa o desactiva el menú de VRChat

voice

Activa o desactiva las funciones de voz

send_message

Envía un mensaje al chatbox de VRChat

Solución de problemas

Problemas comunes

  1. VRChat no responde a los comandos

    • Asegúrese de que OSC esté habilitado en la configuración de VRChat

    • Verifique que los puertos OSC coincidan entre la configuración de VRChat y MCP

    • Reiniciar VRChat y Claude Desktop

  2. El servidor MCP no se inicia

    • Asegúrese de que Node.js 18+ esté instalado

    • Comprobar los argumentos de la línea de comandos para detectar errores

    • Intente ejecutar con el indicador --debug para obtener registros más detallados

    • Utilice npx vrchat-mcp-osc -- --debug si los argumentos directos no funcionan

  3. Problemas de ejecución de NPX

    • Si no se reconocen los argumentos, intente usar el formato de doble guion: npx vrchat-mcp-osc -- --debug

    • En Windows, intente ejecutar en un símbolo del sistema con privilegios de administrador

    • Si tiene problemas con la instalación global, pruebe el enfoque del enlace npm local

Estructura del proyecto

vrchat-mcp-osc/
├── packages/
│   ├── mcp-server/    # MCP server implementation (main entry point)
│   ├── relay-server/  # WebSocket to OSC relay
│   ├── types/         # Shared TypeScript interfaces
│   └── utils/         # Common utilities
└── pnpm-workspace.yaml  # Workspace configuration

Desarrollo

Construir desde la fuente

# Clone the repository
git clone https://github.com/Krekun/vrchat-mcp-osc
cd vrchat-mcp-osc

# Install dependencies
pnpm install

# Build all packages
pnpm -r build

# Development mode
pnpm -r dev

Licencia

VRChat MCP OSC tiene doble licencia de la siguiente manera:

Para uso no comercial: Puede usar, modificar y redistribuir el software bajo los términos de la Licencia MIT. (Consulte el archivo de la Licencia MIT para más detalles).

Para uso comercial: el uso comercial de este software requiere una licencia comercial separada.

Al utilizar este software bajo la Licencia MIT con fines no comerciales, usted acepta los términos de dicha licencia. Los usuarios comerciales deben obtener una licencia comercial, como se describe anteriormente.

Expresiones de gratitud

  • Equipo de VRChat para la integración de OSC

  • Protocolo de contexto del modelo para la interfaz de IA estandarizada

  • Antrópico para la implementación del MCP de Claude

Available Tools

12 tools
get_avatar_listB

Get a list of available avatars.

Inputs: no named parameters.

get_avatar_nameB

Get the name of the current avatar.

Inputs: no named parameters.

get_avatar_parametersB

Get a list of parameters available on the current avatar.

Inputs: no named parameters.

jumpB

Make the avatar jump.

Inputs: no named parameters.

look_directionC

Turn to look in a specific direction.

Inputs: direction (required), duration.

move_avatarC

Move the avatar in a specific direction.

Inputs: direction (required), duration.

send_messageB

Send a message to the VRChat chatbox.

Inputs: message (required), send_immediately.

set_avatarC

Change to a specific avatar.

Inputs: avatar_id (required).

set_avatar_parameterC

Set a parameter on the current avatar.

Inputs: parameter_name (required), value (required).

set_emote_parameterC

Set VRCEmote on the current avatar.

Inputs: value (required).

voiceC

Toggle voice

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have distinct purposes, but there is some potential overlap between 'move_avatar' and 'look_direction' for avatar movement/positioning, and 'set_avatar_parameter' and 'set_emote_parameter' both involve parameter setting. The descriptions help clarify differences, but an agent might occasionally confuse these pairs.

    Naming Consistency4/5

    The naming follows a consistent verb_noun pattern (e.g., get_avatar_list, set_avatar_parameter) with minor deviations like 'jump' and 'voice' being single words instead of verb_noun pairs. Overall, it's readable and mostly predictable, though not perfectly uniform.

    Tool Count5/5

    With 12 tools, this is well-scoped for controlling VRChat avatars via OSC. Each tool serves a clear purpose, such as avatar management, movement, communication, and parameter control, without feeling excessive or insufficient for the domain.

    Completeness4/5

    The toolset covers key aspects like avatar selection, movement, communication, and parameter control, but there are minor gaps such as missing tools for advanced interactions (e.g., gesture controls or environment manipulation). However, agents can likely work around these with the provided tools.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      A Model Context Protocol server that allows AI assistants to interact with the VRChat API, enabling retrieval of user information, friends lists, and other VRChat data through a standardized interface.
      18
      54 npm
      71
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects Blender to AI assistants through the Model Context Protocol, enabling direct AI control of 3D modeling, scene creation, and manipulation via natural language.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connects Blender 3D to AI assistants via the Model Context Protocol, enabling natural language driven 3D scene creation, manipulation, and rendering.
      15
      MIT