Vrchat Mcp

VRChat MCPとは？

VRChat MCP（Model Context Protocol）は、VRChat APIとのインタラクションを促進するために設計されたサーバーです。これにより、開発者やユーザーはVRChat環境内でカスタムモデルやアバターを作成・管理でき、全体的なユーザー体験が向上します。このプロトコルは、VRChatプラットフォームと外部アプリケーションとの間の橋渡しを行い、シームレスな統合と機能を可能にします。

VRChat MCPの特徴

• API統合：VRChat MCPは、開発者がユーザーアバター、ワールド、インタラクションなどのVRChatデータにアクセスし、操作できる強力なAPIを提供します。
• カスタムモデル管理：ユーザーは自分の3Dモデルやアバターをアップロード、管理、カスタマイズでき、VRChatでのパーソナライズされた体験を確保します。
• リアルタイムインタラクション：サーバーはリアルタイム通信をサポートし、ユーザーが自分のモデルやVRChat環境と動的にインタラクションできるようにします。
• ユーザーフレンドリーなインターフェース：MCPサーバーは、モデルやAPIインタラクションの管理プロセスを簡素化する直感的なインターフェースを備えています。
• オープンソース：VRChat MCPはオープンソースプロジェクトであり、コミュニティの貢献や改善を奨励し、協力的な開発環境を育んでいます。

VRChat MCPの使い方

1. サーバーのセットアップ：公式リポジトリからVRChat MCPサーバーをダウンロードします。ドキュメントに記載されたインストール手順に従ってください。
2. APIアクセスの設定：VRChat開発者ポータルからAPIキーを取得し、MCPサーバーの設定にそれを構成します。
3. モデルのアップロード：提供されたインターフェースを使用して、カスタムモデルやアバターをアップロードします。最適なパフォーマンスのためにVRChatの要件を満たしていることを確認してください。
4. APIとのインタラクション：APIエンドポイントを利用して、モデルやアバターに関連するデータを取得、更新、または削除します。利用可能なエンドポイントに関する詳細な指示についてはAPIドキュメントを参照してください。
5. テストと反復：セットアップ後、VRChat環境でモデルをテストします。ユーザーのフィードバックやパフォーマンスに基づいて必要に応じて調整を行います。

よくある質問

Q: VRChat MCPの目的は何ですか？

A: VRChat MCPは、VRChat APIを管理し、インタラクションを行うためのサーバーとして機能し、ユーザーが自分のモデルやアバターを作成・カスタマイズできるようにします。

Q: VRChat MCPは無料で使用できますか？

A: はい、VRChat MCPはオープンソースプロジェクトであり、誰でも無料で使用し、貢献することができます。

Q: VRChat MCPプロジェクトに貢献できますか？

A: もちろんです！貢献は歓迎されます。リポジトリをフォークし、変更を加え、レビューのためにプルリクエストを提出できます。

Q: VRChat MCPを実行するためのシステム要件は何ですか？

A: システム要件は異なる場合がありますが、一般的には、十分なRAMと処理能力を備えた標準的なサーバーセットアップで十分です。具体的な要件についてはドキュメントを参照してください。

Q: VRChat MCPのサポートはどこで見つけられますか？

A: サポートはコミュニティフォーラム、GitHubの問題ページ、またはリポジトリに提供されているドキュメントを通じて見つけることができます。

日本語 | 한국어

This project is a Model Context Protocol (MCP) server for interacting with the VRChat API. It allows you to retrieve various information from VRChat using a standardized protocol.

<a href="https://youtu.be/0MRxhzlFCkw"> <img width="300" src="https://github.com/user-attachments/assets/85c00cc4-46b3-4f66-ab36-bf2891fdb283" alt="YouTube" /> </a> <a href="https://glama.ai/mcp/servers/u763zoyi5a"> <img width="380" height="200" src="https://glama.ai/mcp/servers/u763zoyi5a/badge" /> </a>

Overview

The VRChat MCP server provides a way to access VRChat's API endpoints in a structured manner. It supports a wide range of functionalities, including user authentication, retrieving user and friend information, accessing avatar and world data, and more.

Usage

To start the server, ensure you have the necessary environment variables set:

export VRCHAT_USERNAME=your_username
export VRCHAT_AUTH_TOKEN=your_auth_token

[!NOTE]

How to obtain AUTH TOKEN

You can use the following command to login and obtain an auth token:

$ npx vrchat-auth-token-checker

VRChat Username: your-username
Password: ********

# If 2FA is enabled
2FA Code: 123456

# Success output
Auth Token: authcookie-xxxxx

Command source code

Please handle the obtained token with care as it has a very long lifetime

Then, run the following command:

npx vrchat-mcp

This will launch the MCP server, allowing you to interact with the VRChat API through the defined tools.

Usage with Claude Desktop

To use this MCP server with Claude Desktop, you do not need to run npx vrchat-mcp manually. Instead, add the following configuration to your Claude Desktop config file:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "vrchat-mcp": {
      "command": "npx",
      "args": ["vrchat-mcp"],
      "env": {
        "VRCHAT_USERNAME": "your-username",
        "VRCHAT_AUTH_TOKEN": "your-auth-token"
      }
    }
  }
}

Then, start Claude Desktop as usual. If you have to use nodenv or nvm, you may need to specify the full path to the npx command.

Available Tools

This Model Context Protocol server provides the following VRChat-related tools:

User Related

• vrchat_get_friends_list: Get a list of friends
• vrchat_send_friend_request: Send a friend request

Avatar Related

• vrchat_search_avatars: Search for avatars
• vrchat_select_avatar: Select and switch to a specific avatar

World Related

• vrchat_search_worlds: Search for worlds
• vrchat_list_favorited_worlds: Get a list of favorited worlds

Instance Related

• vrchat_create_instance: Create a new instance
• vrchat_get_instance: Get information about a specific instance

Group Related

• vrchat_search_groups: Search for groups
• vrchat_join_group: Join a group

Favorites Related

• vrchat_list_favorites: Get a list of favorites
• vrchat_add_favorite: Add a new favorite
• vrchat_list_favorite_groups: Get a list of favorite groups

Invite Related

• vrchat_list_invite_messages: Get a list of invite messages
• vrchat_request_invite: Request an invite
• vrchat_get_invite_message: Get a specific invite message

Notification Related

• vrchat_get_notifications: Get a list of notifications

Debugging

First, build the project:

npm install
npm run build

Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.

You can launch the MCP Inspector via npm with this command:

npx @modelcontextprotocol/inspector "./dist/main.js"

Be sure that environment variables are properly configured.

Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.

Publishing

To publish a new version of the package, follow these steps:

1. Pull the latest code from the main branch

   git checkout main
   git pull origin main
   

2. Build the package

   npm run build
   

3. Publish to npm

   npm publish
   

4. Push changes to the remote repository

   git push origin main --tags
   

Contributing

Contributions are welcome! Please fork the repository and submit a pull request for any improvements or bug fixes.

License

This project is licensed under the MIT License. See the LICENSE file for details.