Skip to main content
Glama
enesjakozh

VRChat MCP OSC

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

VRChat MCP OSC

VRChat MCP OSC は、モデルコンテキストプロトコル (MCP) を使用して AI アシスタントと VRChat 間のブリッジを提供し、仮想現実環境での AI 駆動型アバター制御とインタラクションを可能にします。

概要

VRChat との通信に OSC (Open Sound Control) を活用することで、 VRChat MCP OSC はClaude のような AI アシスタントに次のことを可能にします。

  • アバターのパラメータと表情を制御する

  • VRChatでメッセージを送信する

  • 様々なVRイベントに対応
    さらに、モデル コンテキスト プロトコルによって提供される高レベル API を通じて、さらに多くのことが可能になります。

主な特徴

  • アバターコントロール：アバターのパラメータと表情を操作する

  • 移動制御：アバターの移動と向きを直接制御

  • コミュニケーション: VRChatのチャットボックスからメッセージを送信する

  • メニューアクセス: VRChatのメニューとインターフェース要素を切り替える

  • アバター情報: アバターのプロパティとパラメータを照会する

  • シームレスなVRChat統合：アバター構成の自動検出

システム要件

  • Node.js 18以上

  • OSC を有効にした VRChat

  • Claude Desktop（MCP サポート付き）

Claude Desktopでの使用

クローンとnpmリンク

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

Claudeデスクトップの設定

claude_desktop_config.jsonファイルを編集して Claude Desktop を構成します。

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

コマンドラインオプション

サーバーはカスタマイズのためにさまざまなコマンドライン引数をサポートしています。

# 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" ] } } }

利用可能なオプション

オプション

説明

デフォルト

注記

--websocket-port <port>

WebSocketポート

8765

WebSocket通信の場合

--websocket-host <host>

WebSocketホスト

ローカルホスト

WebSocket通信の場合

--osc-send-port <port>

OSC送信ポート

9000

VRChatへの送信ポート

--osc-send-ip <ip>

OSC送信IP

127.0.0.1

VRChatへの送信先アドレス

--osc-receive-port <port>

OSC受信ポート

9001

VRChatからの受信ポート

--osc-receive-ip <ip>

OSC受信IP

127.0.0.1

VRChatからの受信アドレス

--debug

デバッグログを有効にする

間違い

詳細ログを出力する

--no-relay

リレーサーバーを無効にする

間違い

リレーサーバーを使用しない場合

利用可能なMCPツール

VRChat MCP OSC は、次の MCP ツールを AI アシスタントに公開します。

ツール名

説明

get_avatar_name

現在のアバターの名前を取得します

get_avatar_parameters

利用可能なアバターパラメータを一覧表示します

set_avatar_parameter

特定のアバターパラメータを設定する

set_emote_parameter

アバターエモートをトリガーする

move_avatar

アバターを特定の方向に移動させます

look_direction

アバターの視線方向を制御します

jump

アバターをジャンプさせる

menu

VRChatメニューを切り替えます

voice

音声機能を切り替える

send_message

VRChatチャットボックスにメッセージを送信します

トラブルシューティング

よくある問題

  1. VRChatがコマンドに応答しない

    • VRChat設定でOSCが有効になっていることを確認してください

    • VRChatとMCPの設定間でOSCポートが一致していることを確認します

    • VRChatとClaude Desktopを再起動します

  2. MCP サーバーが起動しない

    • Node.js 18以上がインストールされていることを確認する

    • コマンドライン引数にエラーがないか確認する

    • より詳細なログを取得するには、 --debugフラグを付けて実行してみてください。

    • 直接引数が機能しない場合は、 npx vrchat-mcp-osc -- --debugを使用してください。

  3. NPX実行の問題

    • 引数が認識されない場合は、二重ダッシュ形式を試してください: npx vrchat-mcp-osc -- --debug

    • Windowsでは、管理者権限でコマンドプロンプトから実行してみてください。

    • グローバルインストールで問題がある場合は、ローカルnpmリンクアプローチを試してください。

プロジェクト構造

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

発達

ソースからビルド

# 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

ライセンス

VRChat MCP OSC は次のようにデュアルライセンスされます。

非商用利用の場合：MITライセンスの条件に従って、ソフトウェアを使用、変更、再配布することができます。（詳細については、MITライセンスファイルを参照してください。）

商用利用の場合: このソフトウェアを商用利用するには、別途商用ライセンスが必要です。

このソフトウェアをMITライセンスに基づいて非営利目的で使用する場合、当該ライセンスの条件に同意したことになります。商用目的で使用する場合、上記の商用ライセンスを取得する必要があります。

謝辞

  • OSC統合のVRChatチーム

  • 標準化された AI インターフェースのためのモデルコンテキストプロトコル

  • Claude の MCP 実装における Anthropic

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

AI アシスタントと VRChat 間のブリッジを提供し、モデル コンテキスト プロトコルを通じて仮想現実環境での AI 駆動型アバター制御とインタラクションを可能にします。

  1. 概要
    1. 主な特徴
      1. システム要件
        1. Claude Desktopでの使用
          1. クローンとnpmリンク
          2. Claudeデスクトップの設定
          3. コマンドラインオプション
          4. 利用可能なオプション
        2. 利用可能なMCPツール
          1. トラブルシューティング
            1. よくある問題
          2. プロジェクト構造
            1. 発達
              1. ソースからビルド
            2. ライセンス
              1. 謝辞

                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