[{"_1":2,"_372":-5,"_373":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_230":231},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",12064106,"membership","referenceId","0198c8b2-9818-7118-852f-50dab565c2f1","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_65":-5,"_66":28,"_29":67,"_145":146,"_228":229},"availableLocales",[28,40,47,53,59],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Provides a bridge between AI assistants and VRChat, enabling AI-driven avatar control and interactions in virtual reality environments through the Model Context Protocol.","name","VRChat MCP OSC","readme","# VRChat MCP OSC\n\n**VRChat MCP OSC** provides a bridge between AI assistants and VRChat using the Model Context Protocol (MCP), enabling AI-driven avatar control and interactions in virtual reality environments. \n\n\n## Overview\n\nBy leveraging OSC (Open Sound Control) to communicate with VRChat, **VRChat MCP OSC** allows AI assistants such as Claude to:\n- Control avatar parameters and expressions\n- Send messages in VRChat\n- Respond to various VR events \nAnd more—all through the high-level API provided by the Model Context Protocol.\n\n\n## Key Features\n\n- **Avatar Control**: Manipulate avatar parameters and expressions\n- **Movement Control**: Direct avatar movement and orientation\n- **Communication**: Send messages through VRChat's chatbox\n- **Menu Access**: Toggle VRChat menu and interface elements\n- **Avatar Information**: Query avatar properties and parameters\n- **Seamless VRChat Integration**: Automatic detection of avatar configurations\n\n## System Requirements\n\n- Node.js 18 or higher\n- VRChat with OSC enabled\n- Claude Desktop (with MCP support)\n\n## Using with Claude Desktop\n\n### Clone and npm link\n\n```bash\ngit clone https://github.com/Krekun/vrchat-mcp-osc\ncd vrchat-mcp-osc\nnpm link\n```\n\n### Configure Claude Desktop\n\nConfigure Claude Desktop by editing the `claude_desktop_config.json` file:\n\n```json\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\"\n ]\n }\n }\n}\n```\n\n### Command Line Options\n\nThe server supports various command-line arguments for customization:\n\n```bash\n# Claude Desktop configuration\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\",\n \"--websocket-port\", \"8765\",\n \"--websocket-host\", \"localhost\",\n \"--osc-send-port\", \"9000\",\n \"--osc-send-ip\", \"127.0.0.1\",\n \"--osc-receive-port\", \"9001\",\n \"--osc-receive-ip\", \"127.0.0.1\",\n \"--debug\" \n ]\n }\n }\n}\n```\n\n### Available Options\n\n| Option | Description | Default | Notes |\n|--------|-------------|---------|-------|\n| `--websocket-port ` | WebSocket port | 8765 | For WebSocket communication |\n| `--websocket-host ` | WebSocket host | localhost | For WebSocket communication |\n| `--osc-send-port ` | OSC send port | 9000 | Port for sending to VRChat |\n| `--osc-send-ip ` | OSC send IP | 127.0.0.1 | Address for sending to VRChat |\n| `--osc-receive-port ` | OSC receive port | 9001 | Port for receiving from VRChat |\n| `--osc-receive-ip ` | OSC receive IP | 127.0.0.1 | Address for receiving from VRChat |\n| `--debug` | Enable debug logging | false | Output detailed logs |\n| `--no-relay` | Disable relay server | false | When not using relay server |\n\n## Available MCP Tools\n\nVRChat MCP OSC exposes the following MCP tools to AI assistants:\n\n| Tool Name | Description |\n|-----------|-------------|\n| `get_avatar_name` | Retrieves the current avatar's name |\n| `get_avatar_parameters` | Lists available avatar parameters |\n| `set_avatar_parameter` | Sets a specific avatar parameter |\n| `set_emote_parameter` | Triggers avatar emotes |\n| `move_avatar` | Moves the avatar in a specific direction |\n| `look_direction` | Controls avatar's view direction |\n| `jump` | Makes the avatar jump |\n| `menu` | Toggles the VRChat menu |\n| `voice` | Toggles voice features |\n| `send_message` | Sends a message to the VRChat chatbox |\n\n\n## Troubleshooting\n\n### Common Issues\n\n1. **VRChat not responding to commands**\n - Ensure OSC is enabled in VRChat settings\n - Check that the OSC ports match between VRChat and MCP configuration\n - Restart VRChat and Claude Desktop\n\n2. **MCP server not starting**\n - Ensure Node.js 18+ is installed\n - Check command line arguments for errors\n - Try running with `--debug` flag for more detailed logs\n - Use `npx vrchat-mcp-osc -- --debug` if direct arguments don't work\n\n3. **NPX execution issues**\n - If arguments aren't being recognized, try using the double dash format: `npx vrchat-mcp-osc -- --debug`\n - On Windows, try running in a command prompt with administrator privileges\n - If you're having trouble with global installation, try the local npm link approach\n\n## Project Structure\n\n```\nvrchat-mcp-osc/\n├── packages/\n│ ├── mcp-server/ # MCP server implementation (main entry point)\n│ ├── relay-server/ # WebSocket to OSC relay\n│ ├── types/ # Shared TypeScript interfaces\n│ └── utils/ # Common utilities\n└── pnpm-workspace.yaml # Workspace configuration\n```\n\n## Development\n\n### Build From Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/Krekun/vrchat-mcp-osc\ncd vrchat-mcp-osc\n\n# Install dependencies\npnpm install\n\n# Build all packages\npnpm -r build\n\n# Development mode\npnpm -r dev\n```\n\n## License\nVRChat MCP OSC is dual-licensed as follows:\n\nFor Non-Commercial Use:\nYou may use, modify, and redistribute the software under the terms of the MIT License.\n(See the MIT License file for details.)\n\nFor Commercial Use:\nCommercial use of this software requires a separate commercial license.\n\n\nBy using this software under the MIT License for non-commercial purposes, you agree to the terms of that license. Commercial users must obtain a commercial license as described above.\n\n## Acknowledgments\n\n- VRChat team for the OSC integration\n- Model Context Protocol for the standardized AI interface\n- Anthropic for Claude's MCP implementation\n","English","tag","en-US",{"_29":41,"_33":45,"_38":46},{"_31":42,"_33":43,"_35":44},"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.","OSC de MCP de VRChat","# OSC de MCP de VRChat\n\n**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.\n\n## Descripción general\n\nAl aprovechar OSC (Open Sound Control) para comunicarse con VRChat, **VRChat MCP OSC** permite a los asistentes de IA como Claude:\n\n* Controlar los parámetros y expresiones del avatar\n* Enviar mensajes en VRChat\n* Responder a diversos eventos de realidad virtual\\\n Y mucho más, todo a través de la API de alto nivel proporcionada por el Protocolo de Contexto de Modelo.\n\n## Características principales\n\n* **Control de avatar** : manipule los parámetros y expresiones del avatar\n* **Control de movimiento** : movimiento y orientación directos del avatar\n* **Comunicación** : Envía mensajes a través del chatbox de VRChat\n* **Acceso al menú** : alternar entre el menú y los elementos de la interfaz de VRChat\n* **Información del avatar** : Consultar propiedades y parámetros del avatar\n* **Integración perfecta con VRChat** : detección automática de configuraciones de avatar\n\n## Requisitos del sistema\n\n* Node.js 18 o superior\n* VRChat con OSC habilitado\n* Claude Desktop (con soporte MCP)\n\n## Uso con Claude Desktop\n\n### Clonar y vincular npm\n\n```bash\ngit clone https://github.com/Krekun/vrchat-mcp-osc\ncd vrchat-mcp-osc\nnpm link\n```\n\n### Configurar Claude Desktop\n\nConfigure Claude Desktop editando el archivo `claude_desktop_config.json` :\n\n```json\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\"\n ]\n }\n }\n}\n```\n\n### Opciones de línea de comandos\n\nEl servidor admite varios argumentos de línea de comandos para la personalización:\n\n```bash\n# Claude Desktop configuration\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\",\n \"--websocket-port\", \"8765\",\n \"--websocket-host\", \"localhost\",\n \"--osc-send-port\", \"9000\",\n \"--osc-send-ip\", \"127.0.0.1\",\n \"--osc-receive-port\", \"9001\",\n \"--osc-receive-ip\", \"127.0.0.1\",\n \"--debug\" \n ]\n }\n }\n}\n```\n\n### Opciones disponibles\n\n| Opción | Descripción | Por defecto | Notas |\n| --------------------------- | ----------------------------------------- | ----------- | ------------------------------------------------- |\n| `--websocket-port ` | Puerto WebSocket | 8765 | Para la comunicación WebSocket |\n| `--websocket-host ` | Host de WebSocket | host local | Para la comunicación WebSocket |\n| `--osc-send-port ` | Puerto de envío OSC | 9000 | Puerto para enviar a VRChat |\n| `--osc-send-ip ` | OSC envía IP | 127.0.0.1 | Dirección para enviar a VRChat |\n| `--osc-receive-port ` | Puerto de recepción OSC | 9001 | Puerto para recibir desde VRChat |\n| `--osc-receive-ip ` | OSC recibe IP | 127.0.0.1 | Dirección para recibir de VRChat |\n| `--debug` | Habilitar el registro de depuración | FALSO | Generar registros detallados |\n| `--no-relay` | Deshabilitar el servidor de retransmisión | FALSO | Cuando no se utiliza el servidor de retransmisión |\n\n## Herramientas MCP disponibles\n\nVRChat MCP OSC expone las siguientes herramientas MCP a los asistentes de IA:\n\n| Nombre de la herramienta | Descripción |\n| ------------------------ | --------------------------------------------- |\n| `get_avatar_name` | Recupera el nombre del avatar actual |\n| `get_avatar_parameters` | Enumera los parámetros de avatar disponibles |\n| `set_avatar_parameter` | Establece un parámetro de avatar específico |\n| `set_emote_parameter` | Activa los gestos del avatar |\n| `move_avatar` | Mueve el avatar en una dirección específica. |\n| `look_direction` | Controla la dirección de la vista del avatar. |\n| `jump` | Hace que el avatar salte |\n| `menu` | Activa o desactiva el menú de VRChat |\n| `voice` | Activa o desactiva las funciones de voz |\n| `send_message` | Envía un mensaje al chatbox de VRChat |\n\n## Solución de problemas\n\n### Problemas comunes\n\n1. **VRChat no responde a los comandos**\n\n * Asegúrese de que OSC esté habilitado en la configuración de VRChat\n * Verifique que los puertos OSC coincidan entre la configuración de VRChat y MCP\n * Reiniciar VRChat y Claude Desktop\n\n2. **El servidor MCP no se inicia**\n\n * Asegúrese de que Node.js 18+ esté instalado\n * Comprobar los argumentos de la línea de comandos para detectar errores\n * Intente ejecutar con el indicador `--debug` para obtener registros más detallados\n * Utilice `npx vrchat-mcp-osc -- --debug` si los argumentos directos no funcionan\n\n3. **Problemas de ejecución de NPX**\n\n * Si no se reconocen los argumentos, intente usar el formato de doble guion: `npx vrchat-mcp-osc -- --debug`\n * En Windows, intente ejecutar en un símbolo del sistema con privilegios de administrador\n * Si tiene problemas con la instalación global, pruebe el enfoque del enlace npm local\n\n## Estructura del proyecto\n\n```\nvrchat-mcp-osc/\n├── packages/\n│ ├── mcp-server/ # MCP server implementation (main entry point)\n│ ├── relay-server/ # WebSocket to OSC relay\n│ ├── types/ # Shared TypeScript interfaces\n│ └── utils/ # Common utilities\n└── pnpm-workspace.yaml # Workspace configuration\n```\n\n## Desarrollo\n\n### Construir desde la fuente\n\n```bash\n# Clone the repository\ngit clone https://github.com/Krekun/vrchat-mcp-osc\ncd vrchat-mcp-osc\n\n# Install dependencies\npnpm install\n\n# Build all packages\npnpm -r build\n\n# Development mode\npnpm -r dev\n```\n\n## Licencia\n\nVRChat MCP OSC tiene doble licencia de la siguiente manera:\n\nPara 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).\n\nPara uso comercial: el uso comercial de este software requiere una licencia comercial separada.\n\nAl 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.\n\n## Expresiones de gratitud\n\n* Equipo de VRChat para la integración de OSC\n* Protocolo de contexto del modelo para la interfaz de IA estandarizada\n* Antrópico para la implementación del MCP de Claude","Spanish","es-ES",{"_29":48,"_33":51,"_38":52},{"_31":49,"_33":34,"_35":50},"AI アシスタントと VRChat 間のブリッジを提供し、モデルコンテキストプロトコルを通じて仮想現実環境での AI 駆動型アバター制御とインタラクションを可能にします。","# VRChat MCP OSC\n\n**VRChat MCP OSC は**、モデルコンテキストプロトコル (MCP) を使用して AI アシスタントと VRChat 間のブリッジを提供し、仮想現実環境での AI 駆動型アバター制御とインタラクションを可能にします。\n\n## 概要\n\nVRChat との通信に OSC (Open Sound Control) を活用することで、 **VRChat MCP OSC は**Claude のような AI アシスタントに次のことを可能にします。\n\n* アバターのパラメータと表情を制御する\n* VRChatでメッセージを送信する\n* 様々なVRイベントに対応\\\n さらに、モデルコンテキストプロトコルによって提供される高レベル API を通じて、さらに多くのことが可能になります。\n\n## 主な特徴\n\n* **アバターコントロール**：アバターのパラメータと表情を操作する\n* **移動制御**：アバターの移動と向きを直接制御\n* **コミュニケーション**: VRChatのチャットボックスからメッセージを送信する\n* **メニューアクセス**: VRChatのメニューとインターフェース要素を切り替える\n* **アバター情報**: アバターのプロパティとパラメータを照会する\n* **シームレスなVRChat統合**：アバター構成の自動検出\n\n## システム要件\n\n* Node.js 18以上\n* OSC を有効にした VRChat\n* Claude Desktop（MCP サポート付き）\n\n## Claude Desktopでの使用\n\n### クローンとnpmリンク\n\n```bash\ngit clone https://github.com/Krekun/vrchat-mcp-osc\ncd vrchat-mcp-osc\nnpm link\n```\n\n### Claudeデスクトップの設定\n\n`claude_desktop_config.json`ファイルを編集して Claude Desktop を構成します。\n\n```json\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\"\n ]\n }\n }\n}\n```\n\n### コマンドラインオプション\n\nサーバーはカスタマイズのためにさまざまなコマンドライン引数をサポートしています。\n\n```bash\n# Claude Desktop configuration\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\",\n \"--websocket-port\", \"8765\",\n \"--websocket-host\", \"localhost\",\n \"--osc-send-port\", \"9000\",\n \"--osc-send-ip\", \"127.0.0.1\",\n \"--osc-receive-port\", \"9001\",\n \"--osc-receive-ip\", \"127.0.0.1\",\n \"--debug\" \n ]\n }\n }\n}\n```\n\n### 利用可能なオプション\n\n| オプション | 説明 | デフォルト | 注記 |\n| --------------------------- | ------------- | --------- | --------------- |\n| `--websocket-port ` | WebSocketポート | 8765 | WebSocket通信の場合 |\n| `--websocket-host ` | WebSocketホスト | ローカルホスト | WebSocket通信の場合 |\n| `--osc-send-port ` | OSC送信ポート | 9000 | VRChatへの送信ポート |\n| `--osc-send-ip ` | OSC送信IP | 127.0.0.1 | VRChatへの送信先アドレス |\n| `--osc-receive-port ` | OSC受信ポート | 9001 | VRChatからの受信ポート |\n| `--osc-receive-ip ` | OSC受信IP | 127.0.0.1 | VRChatからの受信アドレス |\n| `--debug` | デバッグログを有効にする | 間違い | 詳細ログを出力する |\n| `--no-relay` | リレーサーバーを無効にする | 間違い | リレーサーバーを使用しない場合 |\n\n## 利用可能なMCPツール\n\nVRChat MCP OSC は、次の MCP ツールを AI アシスタントに公開します。\n\n| ツール名 | 説明 |\n| ----------------------- | -------------------------- |\n| `get_avatar_name` | 現在のアバターの名前を取得します |\n| `get_avatar_parameters` | 利用可能なアバターパラメータを一覧表示します |\n| `set_avatar_parameter` | 特定のアバターパラメータを設定する |\n| `set_emote_parameter` | アバターエモートをトリガーする |\n| `move_avatar` | アバターを特定の方向に移動させます |\n| `look_direction` | アバターの視線方向を制御します |\n| `jump` | アバターをジャンプさせる |\n| `menu` | VRChatメニューを切り替えます |\n| `voice` | 音声機能を切り替える |\n| `send_message` | VRChatチャットボックスにメッセージを送信します |\n\n## トラブルシューティング\n\n### よくある問題\n\n1. **VRChatがコマンドに応答しない**\n\n * VRChat設定でOSCが有効になっていることを確認してください\n * VRChatとMCPの設定間でOSCポートが一致していることを確認します\n * VRChatとClaude Desktopを再起動します\n\n2. **MCP サーバーが起動しない**\n\n * Node.js 18以上がインストールされていることを確認する\n * コマンドライン引数にエラーがないか確認する\n * より詳細なログを取得するには、 `--debug`フラグを付けて実行してみてください。\n * 直接引数が機能しない場合は、 `npx vrchat-mcp-osc -- --debug`を使用してください。\n\n3. **NPX実行の問題**\n\n * 引数が認識されない場合は、二重ダッシュ形式を試してください: `npx vrchat-mcp-osc -- --debug`\n * Windowsでは、管理者権限でコマンドプロンプトから実行してみてください。\n * グローバルインストールで問題がある場合は、ローカルnpmリンクアプローチを試してください。\n\n## プロジェクト構造\n\n```\nvrchat-mcp-osc/\n├── packages/\n│ ├── mcp-server/ # MCP server implementation (main entry point)\n│ ├── relay-server/ # WebSocket to OSC relay\n│ ├── types/ # Shared TypeScript interfaces\n│ └── utils/ # Common utilities\n└── pnpm-workspace.yaml # Workspace configuration\n```\n\n## 発達\n\n### ソースからビルド\n\n```bash\n# Clone the repository\ngit clone https://github.com/Krekun/vrchat-mcp-osc\ncd vrchat-mcp-osc\n\n# Install dependencies\npnpm install\n\n# Build all packages\npnpm -r build\n\n# Development mode\npnpm -r dev\n```\n\n## ライセンス\n\nVRChat MCP OSC は次のようにデュアルライセンスされます。\n\n非商用利用の場合：MITライセンスの条件に従って、ソフトウェアを使用、変更、再配布することができます。（詳細については、MITライセンスファイルを参照してください。）\n\n商用利用の場合: このソフトウェアを商用利用するには、別途商用ライセンスが必要です。\n\nこのソフトウェアをMITライセンスに基づいて非営利目的で使用する場合、当該ライセンスの条件に同意したことになります。商用目的で使用する場合、上記の商用ライセンスを取得する必要があります。\n\n## 謝辞\n\n* OSC統合のVRChatチーム\n* 標準化された AI インターフェースのためのモデルコンテキストプロトコル\n* Claude の MCP 実装における Anthropic","Japanese","ja-JP",{"_29":54,"_33":57,"_38":58},{"_31":55,"_33":34,"_35":56},"AI 어시스턴트와 VRChat 간의 브리지를 제공하여 모델 컨텍스트 프로토콜을 통해 가상 현실 환경에서 AI 기반 아바타 제어 및 상호 작용을 가능하게 합니다.","# VRChat MCP OSC\n\n**VRChat MCP OSC는** MCP(모델 컨텍스트 프로토콜)를 사용하여 AI 어시스턴트와 VRChat을 연결하여 가상 현실 환경에서 AI 기반 아바타 제어 및 상호 작용을 구현합니다.\n\n## 개요\n\n**VRChat MCP OSC는** OSC(Open Sound Control)를 활용하여 VRChat과 통신함으로써 Claude와 같은 AI 보조원이 다음을 수행할 수 있도록 지원합니다.\n\n* 아바타 매개변수 및 표현식 제어\n* VRChat에서 메시지 보내기\n* 다양한 VR 이벤트에 대응\\\n 그리고 더 많은 기능은 Model Context Protocol이 제공하는 고수준 API를 통해 제공됩니다.\n\n## 주요 특징\n\n* **아바타 제어** : 아바타 매개변수 및 표현 조작\n* **이동 제어** : 아바타의 직접적인 움직임과 방향\n* **소통** : VRChat 채팅창을 통해 메시지 보내기\n* **메뉴 접근** : VRChat 메뉴 및 인터페이스 요소 전환\n* **아바타 정보** : 아바타 속성 및 매개변수 쿼리\n* **원활한 VRChat 통합** : 아바타 구성 자동 감지\n\n## 시스템 요구 사항\n\n* Node.js 18 이상\n* OSC가 활성화된 VRChat\n* Claude Desktop(MCP 지원)\n\n## Claude Desktop과 함께 사용\n\n### 복제 및 npm 링크\n\n지엑스피1\n\n### Claude Desktop 구성\n\n`claude_desktop_config.json` 파일을 편집하여 Claude Desktop을 구성합니다.\n\n```json\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\"\n ]\n }\n }\n}\n```\n\n### 명령줄 옵션\n\n서버는 사용자 정의를 위한 다양한 명령줄 인수를 지원합니다.\n\n```bash\n# Claude Desktop configuration\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\",\n \"--websocket-port\", \"8765\",\n \"--websocket-host\", \"localhost\",\n \"--osc-send-port\", \"9000\",\n \"--osc-send-ip\", \"127.0.0.1\",\n \"--osc-receive-port\", \"9001\",\n \"--osc-receive-ip\", \"127.0.0.1\",\n \"--debug\" \n ]\n }\n }\n}\n```\n\n### 사용 가능한 옵션\n\n| 옵션 | 설명 | 기본 | 노트 |\n| --------------------------- | ------------- | --------- | ------------------- |\n| `--websocket-port ` | 웹소켓 포트 | 8765 | WebSocket 통신을 위해 |\n| `--websocket-host ` | 웹소켓 호스트 | 로컬호스트 | WebSocket 통신을 위해 |\n| `--osc-send-port ` | OSC 송신 포트 | 9000 | VRChat으로 보내기 위한 포트 |\n| `--osc-send-ip ` | OSC가 IP를 보냅니다 | 127.0.0.1 | VRChat으로 보낼 주소 |\n| `--osc-receive-port ` | OSC 수신 포트 | 9001 | VRChat에서 수신하기 위한 포트 |\n| `--osc-receive-ip ` | OSC 수신 IP | 127.0.0.1 | VRChat에서 수신할 주소 |\n| `--debug` | 디버그 로깅 활성화 | 거짓 | 자세한 로그 출력 |\n| `--no-relay` | 릴레이 서버 비활성화 | 거짓 | 릴레이 서버를 사용하지 않을 때 |\n\n## 사용 가능한 MCP 도구\n\nVRChat MCP OSC는 다음과 같은 MCP 도구를 AI 어시스턴트에 제공합니다.\n\n| 도구 이름 | 설명 |\n| ----------------------- | ----------------------- |\n| `get_avatar_name` | 현재 아바타의 이름을 검색합니다 |\n| `get_avatar_parameters` | 사용 가능한 아바타 매개변수를 나열합니다. |\n| `set_avatar_parameter` | 특정 아바타 매개변수를 설정합니다 |\n| `set_emote_parameter` | 아바타 이모티콘을 트리거합니다 |\n| `move_avatar` | 아바타를 특정 방향으로 이동합니다 |\n| `look_direction` | 아바타의 시야 방향을 제어합니다. |\n| `jump` | 아바타를 점프하게 만듭니다 |\n| `menu` | VRChat 메뉴를 전환합니다 |\n| `voice` | 음성 기능을 전환합니다 |\n| `send_message` | VRChat 채팅창에 메시지를 보냅니다. |\n\n## 문제 해결\n\n### 일반적인 문제\n\n1. **VRChat이 명령에 응답하지 않습니다**\n\n * VRChat 설정에서 OSC가 활성화되어 있는지 확인하세요.\n * VRChat과 MCP 구성 간의 OSC 포트가 일치하는지 확인하세요.\n * VRChat 및 Claude Desktop을 다시 시작하세요.\n\n2. **MCP 서버가 시작되지 않습니다**\n\n * Node.js 18+가 설치되어 있는지 확인하세요.\n * 오류에 대한 명령줄 인수를 확인하세요\n * 더 자세한 로그를 보려면 `--debug` 플래그로 실행해보세요.\n * 직접 인수가 작동하지 않으면 `npx vrchat-mcp-osc -- --debug` 사용하세요.\n\n3. **NPX 실행 문제**\n\n * 인수가 인식되지 않으면 이중 대시 형식을 사용해 보세요: `npx vrchat-mcp-osc -- --debug`\n * Windows에서는 관리자 권한으로 명령 프롬프트에서 실행해보세요.\n * 글로벌 설치에 문제가 있는 경우 로컬 npm 링크 접근 방식을 시도해 보세요.\n\n## 프로젝트 구조\n\n```\nvrchat-mcp-osc/\n├── packages/\n│ ├── mcp-server/ # MCP server implementation (main entry point)\n│ ├── relay-server/ # WebSocket to OSC relay\n│ ├── types/ # Shared TypeScript interfaces\n│ └── utils/ # Common utilities\n└── pnpm-workspace.yaml # Workspace configuration\n```\n\n## 개발\n\n### 소스에서 빌드\n\n```bash\n# Clone the repository\ngit clone https://github.com/Krekun/vrchat-mcp-osc\ncd vrchat-mcp-osc\n\n# Install dependencies\npnpm install\n\n# Build all packages\npnpm -r build\n\n# Development mode\npnpm -r dev\n```\n\n## 특허\n\nVRChat MCP OSC는 다음과 같이 이중 라이센스를 받았습니다.\n\n비상업적 사용: MIT 라이선스 조건에 따라 소프트웨어를 사용, 수정 및 재배포할 수 있습니다. (자세한 내용은 MIT 라이선스 파일을 참조하십시오.)\n\n상업적 사용: 이 소프트웨어를 상업적으로 사용하려면 별도의 상업적 라이선스가 필요합니다.\n\n비상업적 목적으로 MIT 라이선스에 따라 이 소프트웨어를 사용하는 경우, 해당 라이선스 조건에 동의하는 것으로 간주됩니다. 상업적 사용자는 위에 설명된 대로 상업적 라이선스를 취득해야 합니다.\n\n## 감사의 말\n\n* OSC 통합을 위한 VRChat 팀\n* 표준화된 AI 인터페이스를 위한 모델 컨텍스트 프로토콜\n* Claude의 MCP 구현을 위한 Anthropic","Korean","ko-KR",{"_29":60,"_33":63,"_38":64},{"_31":61,"_33":34,"_35":62},"在 AI 助手和 VRChat 之间架起一座桥梁，通过模型上下文协议实现虚拟现实环境中 AI 驱动的化身控制和交互。","# VRChat MCP OSC\n\n**VRChat MCP OSC**使用模型上下文协议 (MCP) 在 AI 助手和 VRChat 之间架起了一座桥梁，实现了虚拟现实环境中 AI 驱动的化身控制和交互。\n\n## 概述\n\n通过利用 OSC（开放声音控制）与 VRChat 进行通信， **VRChat MCP OSC**允许 Claude 等 AI 助手：\n\n* 控制虚拟形象参数和表情\n* 在 VRChat 中发送消息\n* 响应各种VR事件\\\n 还有更多——所有这些都通过模型上下文协议提供的高级 API 实现。\n\n## 主要特点\n\n* **头像控制**：操控头像参数和表情\n* **运动控制**：直接控制虚拟角色的运动和方向\n* **通信**：通过 VRChat 的聊天框发送消息\n* **菜单访问**：切换 VRChat 菜单和界面元素\n* **头像信息**：查询头像属性及参数\n* **无缝 VRChat 集成**：自动检测头像配置\n\n## 系统要求\n\n* Node.js 18 或更高版本\n* 启用 OSC 的 VRChat\n* Claude Desktop（支持 MCP）\n\n## 与 Claude Desktop 一起使用\n\n### 克隆和 npm 链接\n\n```bash\ngit clone https://github.com/Krekun/vrchat-mcp-osc\ncd vrchat-mcp-osc\nnpm link\n```\n\n### 配置 Claude 桌面\n\n通过编辑`claude_desktop_config.json`文件来配置 Claude Desktop：\n\n```json\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\"\n ]\n }\n }\n}\n```\n\n### 命令行选项\n\n该服务器支持各种命令行参数进行定制：\n\n```bash\n# Claude Desktop configuration\n{\n \"mcpServers\": {\n \"vrchat-mcp-osc\": {\n \"command\": \"npx\",\n \"args\": [\n \"vrchat-mcp-osc\",\n \"--websocket-port\", \"8765\",\n \"--websocket-host\", \"localhost\",\n \"--osc-send-port\", \"9000\",\n \"--osc-send-ip\", \"127.0.0.1\",\n \"--osc-receive-port\", \"9001\",\n \"--osc-receive-ip\", \"127.0.0.1\",\n \"--debug\" \n ]\n }\n }\n}\n```\n\n### 可用选项\n\n| 选项 | 描述 | 默认 | 笔记 |\n| --------------------------- | ------------ | --------- | ----------------- |\n| `--websocket-port ` | WebSocket 端口 | 8765 | 对于 WebSocket 通信 |\n| `--websocket-host ` | WebSocket 主机 | 本地主机 | 对于 WebSocket 通信 |\n| `--osc-send-port ` | OSC发送端口 | 9000 | 发送到 VRChat 的端口 |\n| `--osc-send-ip ` | OSC发送IP | 127.0.0.1 | 发送至 VRChat 的地址 |\n| `--osc-receive-port ` | OSC接收端口 | 9001 | 用于接收 VRChat 消息的端口 |\n| `--osc-receive-ip ` | OSC接收IP | 127.0.0.1 | VRChat 接收地址 |\n| `--debug` | 启用调试日志记录 | 错误的 | 输出详细日志 |\n| `--no-relay` | 禁用中继服务器 | 错误的 | 不使用中继服务器时 |\n\n## 可用的 MCP 工具\n\nVRChat MCP OSC 向 AI 助手公开了以下 MCP 工具：\n\n| 工具名称 | 描述 |\n| ----------------------- | ---------------- |\n| `get_avatar_name` | 检索当前头像的名称 |\n| `get_avatar_parameters` | 列出可用的头像参数 |\n| `set_avatar_parameter` | 设置特定的头像参数 |\n| `set_emote_parameter` | 触发头像表情 |\n| `move_avatar` | 将头像向特定方向移动 |\n| `look_direction` | 控制角色的视线方向 |\n| `jump` | 让角色跳跃 |\n| `menu` | 切换 VRChat 菜单 |\n| `voice` | 切换语音功能 |\n| `send_message` | 向 VRChat 聊天框发送消息 |\n\n## 故障排除\n\n### 常见问题\n\n1. **VRChat 不响应命令**\n\n * 确保在 VRChat 设置中启用 OSC\n * 检查 VRChat 和 MCP 配置之间的 OSC 端口是否匹配\n * 重启 VRChat 和 Claude Desktop\n\n2. **MCP 服务器未启动**\n\n * 确保安装了 Node.js 18+\n * 检查命令行参数是否有错误\n * 尝试使用`--debug`标志运行以获取更详细的日志\n * 如果直接参数不起作用，请使用`npx vrchat-mcp-osc -- --debug`\n\n3. **NPX 执行问题**\n\n * 如果参数无法识别，请尝试使用双破折号格式： `npx vrchat-mcp-osc -- --debug`\n * 在 Windows 上，尝试以管理员权限在命令提示符中运行\n * 如果您在全局安装时遇到问题，请尝试本地 npm 链接方法\n\n## 项目结构\n\n```\nvrchat-mcp-osc/\n├── packages/\n│ ├── mcp-server/ # MCP server implementation (main entry point)\n│ ├── relay-server/ # WebSocket to OSC relay\n│ ├── types/ # Shared TypeScript interfaces\n│ └── utils/ # Common utilities\n└── pnpm-workspace.yaml # Workspace configuration\n```\n\n## 发展\n\n### 从源代码构建\n\n```bash\n# Clone the repository\ngit clone https://github.com/Krekun/vrchat-mcp-osc\ncd vrchat-mcp-osc\n\n# Install dependencies\npnpm install\n\n# Build all packages\npnpm -r build\n\n# Development mode\npnpm -r dev\n```\n\n## 执照\n\nVRChat MCP OSC 是双重许可的，如下所示：\n\n非商业用途：您可以根据 MIT 许可证条款使用、修改和重新分发该软件。（详情请参阅 MIT 许可证文件。）\n\n商业用途：此软件的商业使用需要单独的商业许可。\n\n如果您根据 MIT 许可证将此软件用于非商业用途，即表示您同意该许可证的条款。商业用户必须获得如上所述的商业许可证。\n\n## 致谢\n\n* VRChat 团队负责 OSC 集成\n* 标准化人工智能接口的模型上下文协议\n* Anthropic 为 Claude 的 MCP 实现","Chinese","zh-CN","githubUser","locale",{"_68":69,"_13":70,"_80":32,"_81":32,"_16":82,"_83":84,"_33":34,"_96":97,"_99":-5,"_100":101,"_134":135,"_140":-5,"_91":117,"_141":126,"_94":142,"_143":144},"addedAt","2025-03-26T23:04:45.521521477Z",[71,72,73,74,75,76,77,78,79],"category:app-automation","category:agent-orchestration","category:entertainment-and-media","environment:local","hosting:local-only","language:typescript","security_grade:a","quality_grade:a","license_grade:f","descriptionMarkdown","descriptionPlainText",3842,"integrations",[85],{"_86":87,"_31":93,"_94":95},"brand",{"_88":89,"_33":90,"_91":92},"logoSvgPath","M22.732 6.767H1.268A1.27 1.27 0 0 0 0 8.035v5.296c0 .7.57 1.268 1.268 1.268h18.594l1.725 2.22c.215.275.443.415.68.415.153 0 .296-.06.403-.167.128-.129.193-.308.193-.536l-.002-1.939A1.27 1.27 0 0 0 24 13.331V8.035c0-.7-.569-1.269-1.268-1.269Zm.8 6.564a.8.8 0 0 1-.8.801h-.34v.031l.004 2.371c0 .155-.05.233-.129.233s-.19-.079-.31-.235l-1.866-2.4H1.268a.8.8 0 0 1-.8-.8V8.064a.8.8 0 0 1 .8-.8h21.464a.8.8 0 0 1 .8.8v5.266ZM4.444 8.573c-.127 0-.225.041-.254.15l-.877 3.129-.883-3.128c-.03-.11-.127-.15-.254-.15-.202 0-.473.126-.473.311 0 .012.005.035.011.058l1.114 3.63c.058.173.265.254.485.254s.433-.08.484-.254l1.109-3.63c.005-.023.011-.04.011-.058 0-.179-.27-.312-.473-.312Zm2.925 2.36c.433-.132.757-.49.757-1.153 0-.918-.612-1.207-1.368-1.207H5.614a.234.234 0 0 0-.242.231v3.752c0 .156.184.237.374.237s.376-.081.376-.237V11.05h.484l.82 1.593c.058.115.156.179.26.179.219 0 .467-.203.467-.393a.155.155 0 0 0-.028-.092l-.756-1.403Zm-.61-.473h-.636V9.231h.635c.375 0 .618.162.618.618s-.242.612-.618.612Zm10.056.826h1.004l-.502-1.772-.502 1.772Zm4.684-3.095H9.366a.8.8 0 0 0-.8.8v3.383a.8.8 0 0 0 .8.8h12.132a.8.8 0 0 0 .8-.8V8.992a.8.8 0 0 0-.8-.801Zm-10.946 3.977c.525 0 .571-.374.589-.617.011-.179.173-.236.369-.236.26 0 .38.075.38.369 0 .698-.57 1.142-1.379 1.142-.727 0-1.327-.357-1.327-1.322v-1.61c0-.963.606-1.322 1.333-1.322.802 0 1.374.427 1.374 1.097 0 .3-.121.37-.375.37-.214 0-.37-.064-.375-.238-.012-.178-.052-.57-.6-.57-.387 0-.606.213-.606.663v1.61c0 .45.219.664.617.664Zm4.703.388c0 .156-.19.237-.375.237s-.375-.081-.375-.237V10.9h-1.299v1.656c0 .156-.19.237-.375.237s-.375-.081-.375-.237V8.804c0-.161.185-.23.375-.23s.375.069.375.23v1.507h1.299V8.804c0-.161.185-.23.375-.23s.375.069.375.23v3.752Zm3.198.236c-.127 0-.225-.04-.254-.15l-.22-.768h-1.322l-.219.768c-.029.11-.127.15-.254.15-.202 0-.473-.127-.473-.311 0-.012.006-.035.012-.058l1.114-3.63c.051-.173.265-.254.478-.254s.433.08.485.254l1.114 3.63c.006.023.012.04.012.058 0 .179-.272.311-.473.311Zm2.989-3.543h-.843v3.306c0 .156-.19.237-.375.237s-.375-.081-.375-.237V9.25h-.848c-.15 0-.237-.157-.237-.34 0-.162.075-.336.237-.336h2.44c.162 0 .238.173.238.335 0 .18-.087.34-.237.34Z","VRChat","slug","vrchat","Enables AI-driven avatar control and interactions in VRChat through OSC, allowing manipulation of avatar parameters, movement control, message sending, menu toggling, and retrieval of avatar information.","uid","cuqoxhana6","namespace",{"_91":98},"Krekun","redditPostExternalId","repository",{"_102":-5,"_103":104,"_107":108,"_127":-5,"_128":129,"_130":-5,"_131":132},"argumentsJsonSchema","githubProject",{"_35":36,"_105":106},"url","https://github.com/Krekun/vrchat-mcp-osc","githubRepository",{"_109":110,"_111":112,"_113":114,"_115":116,"_33":117,"_118":119,"_122":123,"_124":-5,"_125":126},"defaultBranch","main","fullName","Krekun/vrchat-mcp-osc","githubTreeId",105011,"language","TypeScript","vrchat-mcp-osc","owner",{"_120":98,"_94":121},"login","CBkkEwxCYf","recentStargazers",0,"spdxLicense","stargazers",12,"glamaJson","inspectable",true,"npmPackage","supportedPlatforms",[133],"WINDOWS","scores",{"_136":123,"_137":138,"_139":138},"license","quality",100,"security","simpleIcon","toolCount","szi385y758","updatedAt","2025-08-19T17:40:00.857857474Z","meta",[147,150,152,159,162,164,167,170,173,176,179,181,184,187,189,191,193,195,197],{"_148":149},"title","VRChat MCP OSC | Glama",{"_151":32,"_33":31},"content",{"_153":154,"_155":156,"_157":158},"href","https://glama.ai/mcp/servers/@Krekun/vrchat-mcp-osc","rel","canonical","tagName","link",{"_151":34,"_160":161},"property","og:title",{"_151":32,"_160":163},"og:description",{"_151":165,"_160":166},"https://glama.ai/logo.png","og:logo",{"_151":168,"_160":169},"https://glama.ai/mcp/servers/@Krekun/vrchat-mcp-osc/og-image","og:image",{"_151":171,"_160":172},"630","og:image:height",{"_151":174,"_160":175},"1200","og:image:width",{"_151":177,"_160":178},"website","og:type",{"_151":154,"_160":180},"og:url",{"_151":182,"_160":183},"Glama – MCP Hosting Platform","og:site_name",{"_151":185,"_33":186},"summary_large_image","twitter:card",{"_151":182,"_33":188},"twitter:title",{"_151":32,"_33":190},"twitter:description",{"_151":168,"_33":192},"twitter:image",{"_151":171,"_33":194},"twitter:image:height",{"_151":174,"_33":196},"twitter:image:width",{"_198":199},"script:ld+json",{"_200":201,"_202":203},"@context","http://schema.org","@graph",[204],{"_200":205,"_206":207,"_208":209},"https://schema.org","@type","BreadcrumbList","itemListElement",[210,217,221,225],{"_206":211,"_212":213,"_33":214,"_215":216},"ListItem","item","/","Glama","position",1,{"_206":211,"_212":218,"_33":219,"_215":220},"/mcp","MCP",2,{"_206":211,"_212":222,"_33":223,"_215":224},"/mcp/servers","Servers",3,{"_206":211,"_212":226,"_33":34,"_215":227},"/mcp/servers/@Krekun/vrchat-mcp-osc",4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/tools/~toolName/_route",{"_29":232,"_247":-5,"_248":249,"_145":264,"_302":303,"_328":329,"_11":371},{"_68":69,"_13":233,"_80":32,"_81":32,"_234":235,"_16":82,"_33":34,"_96":236,"_100":237,"_134":245,"_140":-5,"_91":117,"_141":126,"_94":142,"_143":246},[71,72,73,74,75,76,77,78,79],"discoverabilityScore",200,{"_91":98},{"_238":-5,"_107":239,"_127":-5,"_130":-5,"_131":244},"environmentVariablesJsonSchema",{"_111":112,"_115":116,"_33":117,"_118":240,"_242":243,"_122":216,"_124":-5,"_125":126},{"_16":241,"_120":98},28791,"pushedAt","2025-03-30T13:00:44.000000000Z",[133],{"_136":123,"_137":138,"_139":138},"2025-08-12T17:33:19.161161058Z","mcpServerInstance","mcpServerTool",{"_31":250,"_16":251,"_252":253,"_261":262,"_33":263},"Toggle Menu.",52040,"inputSchema",{"_254":255,"_256":229,"_257":258,"_259":260},"$schema","http://json-schema.org/draft-07/schema#","additionalProperties","properties",{},"type","object","metaDescription","Control and toggle menus in VRChat using the MCP OSC server, enabling AI-assisted avatar interactions and settings adjustments in virtual reality environments.","menu",[265,267,268,270,272,273,274,275,276,277,278,279,280,281,282,283,284,285,286],{"_148":266},"menu - VRChat MCP OSC | Glama",{"_151":262,"_33":31},{"_153":269,"_155":156,"_157":158},"https://glama.ai/mcp/servers/@Krekun/vrchat-mcp-osc/tools/menu",{"_151":271,"_160":161},"menu - VRChat MCP OSC",{"_151":262,"_160":163},{"_151":165,"_160":166},{"_151":168,"_160":169},{"_151":171,"_160":172},{"_151":174,"_160":175},{"_151":177,"_160":178},{"_151":269,"_160":180},{"_151":182,"_160":183},{"_151":185,"_33":186},{"_151":182,"_33":188},{"_151":262,"_33":190},{"_151":168,"_33":192},{"_151":171,"_33":194},{"_151":174,"_33":196},{"_198":287},{"_200":201,"_202":288},[289],{"_200":205,"_206":207,"_208":290},[291,292,293,294,295,299],{"_206":211,"_212":213,"_33":214,"_215":216},{"_206":211,"_212":218,"_33":219,"_215":220},{"_206":211,"_212":222,"_33":223,"_215":224},{"_206":211,"_212":226,"_33":34,"_215":227},{"_206":211,"_212":296,"_33":297,"_215":298},"/mcp/servers/@Krekun/vrchat-mcp-osc/tools","Tools",5,{"_206":211,"_212":300,"_33":263,"_215":301},"/mcp/servers/@Krekun/vrchat-mcp-osc/tools/menu",6,"relatedMcpServerTools",[304,308,312,316,320,324],{"_29":305,"_33":307},{"_33":34,"_96":306,"_91":117,"_94":142},{"_91":98},"voice",{"_29":309,"_33":311},{"_33":34,"_96":310,"_91":117,"_94":142},{"_91":98},"set_avatar_parameter",{"_29":313,"_33":315},{"_33":34,"_96":314,"_91":117,"_94":142},{"_91":98},"jump",{"_29":317,"_33":319},{"_33":34,"_96":318,"_91":117,"_94":142},{"_91":98},"set_avatar",{"_29":321,"_33":323},{"_33":34,"_96":322,"_91":117,"_94":142},{"_91":98},"move_avatar",{"_29":325,"_33":327},{"_33":34,"_96":326,"_91":117,"_94":142},{"_91":98},"get_avatar_parameters","siblingMcpServerTools",[330,334,338,341,344,348,351,354,358,361,364,368],{"_29":331,"_33":333},{"_96":332,"_91":117,"_94":142},{"_91":98},"get_avatar_list",{"_29":335,"_33":337},{"_96":336,"_91":117,"_94":142},{"_91":98},"get_avatar_name",{"_29":339,"_33":327},{"_96":340,"_91":117,"_94":142},{"_91":98},{"_29":342,"_33":315},{"_96":343,"_91":117,"_94":142},{"_91":98},{"_29":345,"_33":347},{"_96":346,"_91":117,"_94":142},{"_91":98},"look_direction",{"_29":349,"_33":263},{"_96":350,"_91":117,"_94":142},{"_91":98},{"_29":352,"_33":323},{"_96":353,"_91":117,"_94":142},{"_91":98},{"_29":355,"_33":357},{"_96":356,"_91":117,"_94":142},{"_91":98},"send_message",{"_29":359,"_33":319},{"_96":360,"_91":117,"_94":142},{"_91":98},{"_29":362,"_33":311},{"_96":363,"_91":117,"_94":142},{"_91":98},{"_29":365,"_33":367},{"_96":366,"_91":117,"_94":142},{"_91":98},"set_emote_parameter",{"_29":369,"_33":307},{"_96":370,"_91":117,"_94":142},{"_91":98},{"_21":-5},"actionData","errors"]

menu

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from VRChat MCP OSC

Related Tools

MCP directory API