{"id":26528553,"url":"https://github.com/sawa-zen/vrchat-mcp","last_synced_at":"2025-08-25T08:18:19.292Z","repository":{"id":282495794,"uuid":"948365922","full_name":"sawa-zen/vrchat-mcp","owner":"sawa-zen","description":"This project is a Model Context Protocol (MCP) server for interacting with the VRChat API.","archived":false,"fork":false,"pushed_at":"2025-04-05T14:57:58.000Z","size":518,"stargazers_count":29,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-09T18:13:40.050Z","etag":null,"topics":["ai","claude","cline","mcp","vrchat"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sawa-zen.png","metadata":{"files":{"readme":"README.ja.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-14T07:56:53.000Z","updated_at":"2025-04-07T19:34:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"1a65cbe9-d376-4d70-875d-97fd3b9c5cf4","html_url":"https://github.com/sawa-zen/vrchat-mcp","commit_stats":null,"previous_names":["sawa-zen/vrchat-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sawa-zen%2Fvrchat-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sawa-zen%2Fvrchat-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sawa-zen%2Fvrchat-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sawa-zen%2Fvrchat-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sawa-zen","download_url":"https://codeload.github.com/sawa-zen/vrchat-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248085326,"owners_count":21045139,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","claude","cline","mcp","vrchat"],"created_at":"2025-03-21T16:01:34.437Z","updated_at":"2025-08-25T08:18:19.279Z","avatar_url":"https://github.com/sawa-zen.png","language":"TypeScript","funding_links":[],"categories":["Gaming","Messaging MCP Servers","📚 Projects (1974 total)","🤖 AI/ML","Legend","サーバー実装","Gaming and Game Development","MCP 服务器精选列表","MCP Servers","Table of Contents","Uncategorized"],"sub_categories":["Trading \u0026 Exchanges","MCP Servers","💬 \u003ca name=\"communication\"\u003e\u003c/a\u003eCommunication","💬 \u003ca name=\"communication\"\u003e\u003c/a\u003eコミュニケーション","🏃 体育与游戏","💬 Communication","Other Tools and Integrations","Uncategorized"],"readme":"![VRChat MCP](./eyecatch.jpg)\n\n[![npm version](https://badge.fury.io/js/vrchat-mcp.svg)](https://badge.fury.io/js/vrchat-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nこのプロジェクトは、VRChat APIと対話するためのModel Context Protocol (MCP)サーバーです。標準化されたプロトコルを使用してVRChatからさまざまな情報を取得することができます。\n\n\u003ca href=\"https://youtu.be/0MRxhzlFCkw\"\u003e\n  \u003cimg width=\"300\" src=\"https://github.com/user-attachments/assets/85c00cc4-46b3-4f66-ab36-bf2891fdb283\" alt=\"YouTube\" /\u003e\n\u003c/a\u003e\n\n\u003ca href=\"https://glama.ai/mcp/servers/u763zoyi5a\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/u763zoyi5a/badge\" /\u003e\n\u003c/a\u003e\n\n## 概要\n\nVRChat MCPサーバーは、VRChatのAPIエンドポイントに構造化された方法でアクセスする手段を提供します。ユーザー認証、ユーザーおよびフレンド情報の取得、アバターやワールドデータへのアクセスなど、幅広い機能をサポートしています。\n\n## 使用方法\n\nサーバーを起動するには、必要な環境変数を設定してください：\n\n```bash\nexport VRCHAT_USERNAME=your_username\nexport VRCHAT_AUTH_TOKEN=your_auth_token\n```\n\n\u003e [!NOTE]\n\u003e #### AUTH TOKEN の取得方法\n\u003e\n\u003e 以下のコマンドで簡易ログインができ、authトークンを取得できます：\n\u003e ```\n\u003e $ npx vrchat-auth-token-checker\n\u003e\n\u003e VRChat Username: your-username\n\u003e Password: ********\n\u003e\n\u003e # If 2FA is enabled\n\u003e 2FA Code: 123456\n\u003e\n\u003e # Success output\n\u003e Auth Token: authcookie-xxxxx\n\u003e ```\n\u003e [コマンドのソースコード](https://github.com/sawa-zen/vrchat-auth-token-checker)\n\u003e\n\u003e **取得したトークンのライフタイムは非常に長いため慎重に扱ってください**\n\nその後、以下のコマンドを実行します：\n\n```bash\nnpx vrchat-mcp\n```\n\nこれによりMCPサーバーが起動し、定義されたツールを通じてVRChat APIと対話できるようになります。\n\n## Claude Desktopでの使用方法\n\nClaude Desktopを起動する前に設定ファイルに以下の設定を追加してください。設定ファイルの json の場所は各OS以下のようになっています。\n\n- MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"vrchat-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"vrchat-mcp\"],\n      \"env\": {\n        \"VRCHAT_USERNAME\": \"your-username\",\n        \"VRCHAT_AUTH_TOKEN\": \"your-auth-token\"\n      }\n    }\n  }\n}\n```\n\nその後 Claude Desktop を起動してください。nodenvやnvmを使用している場合は、`npx`コマンドのフルパスを指定する必要があるかもしれません。\n\n## 使用可能ツール\n\nこのModel Context Protocolサーバーは、以下のVRChat関連ツールを提供します：\n\n### ユーザー関連\n- vrchat_get_friends_list: フレンドリストの取得\n- vrchat_send_friend_request: フレンドリクエストの送信\n\n### アバター関連\n- vrchat_search_avatars: アバターの検索\n- vrchat_select_avatar: アバターの選択\n\n### ワールド関連\n- vrchat_search_worlds: ワールドの検索\n- vrchat_list_favorited_worlds: お気に入りワールドの取得\n\n### インスタンス関連\n- vrchat_create_instance: インスタンスの作成\n- vrchat_get_instance: インスタンス情報の取得\n\n### グループ関連\n- vrchat_search_groups: グループの検索\n- vrchat_join_group: グループへの参加\n\n### お気に入り関連\n- vrchat_list_favorites: お気に入り一覧の取得\n- vrchat_add_favorite: お気に入りの追加\n- vrchat_list_favorite_groups: お気に入りグループ一覧の取得\n\n### 招待関連\n- vrchat_list_invite_messages: 招待メッセージ一覧の取得\n- vrchat_request_invite: 招待リクエストの送信\n- vrchat_get_invite_message: 招待メッセージの取得\n\n### 通知関連\n- vrchat_get_notifications: 通知リストの取得\n\n## デバッグ\n\nまず、プロジェクトをビルドします：\n\n```bash\nnpm install\nnpm run build\n```\n\nMCP サーバーは stdio を介して実行されるため、デバッグが難しい場合があります。最適なデバッグ体験のために、MCP Inspector の使用を強く推奨します。\n\n以下のコマンドで npm を通じて MCP Inspector を起動できます：\n\n```bash\nnpx @modelcontextprotocol/inspector \"./dist/main.js\"\n```\n\n環境変数が適切に設定されていることを確認してください。\n\n起動すると、Inspector はブラウザでアクセスできる URL を表示します。この URL にアクセスしてデバッグを開始できます。\n\n## パッケージの公開\n\nパッケージを公開するには、以下の手順に従ってください：\n\n1. mainブランチの最新コードをローカルにpullする\n   ```bash\n   git checkout main\n   git pull origin main\n   ```\n\n2. ビルドを実行する\n   ```bash\n   npm run build\n   ```\n\n4. npmにパッケージを公開する\n   ```bash\n   npm publish\n   ```\n\n5. 変更をリモートリポジトリにプッシュする\n   ```bash\n   git push origin main --tags\n   ```\n\n## コントリビューション\n\nコントリビューションを歓迎します！改善やバグ修正のためのプルリクエストを提出する場合は、リポジトリをフォークしてください。\n\n## ライセンス\n\nこのプロジェクトはMITライセンスの下で提供されています。詳細については、LICENSEファイルを参照してください。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsawa-zen%2Fvrchat-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsawa-zen%2Fvrchat-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsawa-zen%2Fvrchat-mcp/lists"}