Skip to main content
Glama
enesjakozh

VRChat MCP OSC

by Krekun
GitHub
TypeScript
13
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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.

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

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

View all tools

Proporciona un puente entre los asistentes de IA y VRChat, lo que permite el control de avatares e interacciones impulsados por IA en entornos de realidad virtual a través del Protocolo de contexto de modelo.

  1. Descripción general
    1. Características principales
      1. Requisitos del sistema
        1. Uso con Claude Desktop
          1. Clonar y vincular npm
          2. Configurar Claude Desktop
          3. Opciones de línea de comandos
          4. Opciones disponibles
        2. Herramientas MCP disponibles
          1. Solución de problemas
            1. Problemas comunes
          2. Estructura del proyecto
            1. Desarrollo
              1. Construir desde la fuente
            2. Licencia
              1. Expresiones de gratitud

                Related MCP Servers

                • Figma MCP Server

                  MatthewDailey
                  A
                  security
                  F
                  license
                  A
                  quality
                  Enables AI assistants to interact with Figma files through the ModelContextProtocol, allowing viewing, commenting, and analyzing Figma designs directly in chat interfaces.
                  Last updated -
                  5
                  725
                  200
                  • Apple

                • VRChat MCP Server

                  sawa-zen
                  A
                  security
                  A
                  license
                  A
                  quality
                  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.
                  Last updated -
                  18
                  8
                  43
                  MIT License
                  • Apple

                • MCP Toolkit

                  zxfgds
                  -
                  security
                  F
                  license
                  -
                  quality
                  A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
                  Last updated -
                  33
                  1

                • Quickchat AI MCP serverofficial

                  quickchatai
                  -
                  security
                  A
                  license
                  -
                  quality
                  Allows users to integrate their custom Quickchat AI Agents into various AI applications (Claude Desktop, Cursor, VS Code, etc.) through the Model Context Protocol, enabling AI-to-AI interactions.
                  Last updated -
                  20
                  MIT License

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/Krekun/vrchat-mcp-osc'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server