Для чего этот сервер?

Этот сервер превращает VRChat API в набор инструментов для AI-ассистентов через протокол MCP. Разработчики используют его, чтобы Claude или другой агент мог искать миры и аватары, отправлять запросы в друзья, управлять избранным или получать уведомления — без ручного кода. Всё работает через одну команду и переменные окружения.

Что он умеет?

Сервер работает с пользователями VRChat: читает профиль текущего пользователя, список друзей, отправляет заявки в друзья. Ищет аватары и переключается на них. Ищет миры, получает список избранных миров, создаёт инстансы и получает информацию о них. Ищет группы и вступает в них. Управляет избранным: читает, добавляет, получает списки групп избранного. Работает с приглашениями: читает список и конкретные сообщения, запрашивает инвайты, смотрит уведомления.

Каталог MCP
sawa-zen/vrchat-mcp

sawa-zen/vrchat-mcp

от sawa-zen

Сервер MCP для VRChat API: ищите аватары, миры, управляйте друзьями, создавайте инстансы, работайте с избранным. Этот инструмент полезен разработчикам и создателям контента для автоматизации запрос...

Github NPM Сайт сервера

README

18 инструментов

Версии

Установить сервер

VRChat MCP

日本語 | 한국어

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.

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

Заметка

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:

Часто задаваемые вопросы

Инструменты были проиндексированы: 21.10.2026

vrchat_add_favorite

Добавить новое избранное.

Параметры

favoriteIdstringобязательный
Должно быть либо AvatarID, либо WorldID, либо UserID.
tagsstring[]обязательный
Теги указывают, к какой группе относится это избранное. Добавление нескольких групп делает так, что оно отображается во всех. Удаление из одной в таком случае удаляет его из всех.
typeenumобязательный
FavoriteType. По умолчанию: friend, Допустимые: world | friend | avatar

vrchat_create_instance

Создаёт новый экземпляр мира.

Параметры

canRequestInviteboolean
closedAtstring
groupAccessTypeenum
hardCloseboolean
inviteOnlyboolean
ownerIdstring | null
queueEnabledboolean
regionenum
roleIdsstring[]
typeenumобязательный
worldIdstringобязательный

vrchat_get_current_user

Получает информацию о вашем пользователе VRChat

Параметры

Без параметров.

vrchat_get_friends_list

Получить список информации о друзьях в VRChat. Можно получить следующую информацию: - "bio" - "bioLinks" - "currentAvatarImageUrl" - "currentAvatarThumbnailImageUrl" - "currentAvatarTags" - "developerType" - "displayName" - "fallbackAvatar" - "id" - "isFriend" - "last_platform" - "last_login" - "profilePicOverride" - "pronouns" - "status" - "statusDescription" - "tags" - "userIcon" - "location" - "friendKey"

Параметры

nnumber
offlineboolean
offsetnumber

vrchat_get_instance

Получить информацию о конкретном инстансе. Примечание: Подробная информация об участниках инстанса доступна только владельцу инстанса.

Параметры

instanceIdstringобязательный
Нужен корректный идентификатор экземпляра.
worldIdstringобязательный
Должен быть корректный world ID.

vrchat_get_invite_message

Возвращает конкретное пригласительное сообщение. Для просмотра сообщений других пользователей требуются учетные данные администратора! Тип сообщения указывает на разную коллекцию сообщений: - message = сообщение при обычном приглашении - response = сообщение при ответе на сообщение - request = сообщение при запросе приглашения - requestResponse = сообщение при ответе на запрос приглашения

Параметры

messageTypeenum
Тип сообщения для получения. Должен быть допустимым InviteMessageType.
slotnumberобязательный
Номер слота сообщения для получения.
userIdstringобязательный
Должен быть валидный идентификатор пользователя.

vrchat_get_notifications

Получить список уведомлений VRChat.

Параметры

afterstring
Возвращает только уведомления, отправленные после этой даты. Игнорируется, если тип — "friendRequest".
hiddenboolean
Возвращать скрытые или нескрытые уведомления. True разрешено только для типа "friendRequest".
nnumber
Количество объектов для возврата. По умолчанию: 60, максимум: 100.
offsetnumber
Смещение от начала сортировки объектов по умолчанию, отсчитываемое от нуля.
sentboolean
Возвращает уведомления, отправленные пользователем. Должно быть false или опущено.
typestring
Отправляет уведомления только этого типа. Использует "all" для всех типов. Этот параметр больше ничего не делает и устарел.

vrchat_join_group

Вступить в группу VRChat по ID

Параметры

groupIdstringобязательный
Должен быть корректный идентификатор группы.

vrchat_list_favorited_worlds

Выводит список избранных миров по фильтрам запроса.

Параметры

featuredboolean
Фильтры для избранных результатов
nnumber
Количество возвращаемых объектов, минимум 1, максимум 100
orderenum
Сортируйте результаты в порядке возрастания или убывания.
sortenum
Порядок сортировки результатов

vrchat_list_favorite_groups

Возвращает список избранных групп пользователя.

Параметры

nnumber
Количество избранных групп для возврата (1-100). По умолчанию — 60.
offsetnumber
Пропустите столько избранных групп, прежде чем начать возвращать результаты.
ownerIdstring
Фильтруйте по ID владельца. Если он не указан, возвращает избранные группы текущего пользователя.

vrchat_list_favorites

Возвращает список избранного.

Параметры

nnumber
Количество возвращаемых избранных (1–100). По умолчанию — 60.
offsetnumber
Пропустить указанное количество избранных элементов перед началом возврата результатов.
tagstring
Фильтровать по тегу (например, "group_0", "group_1").
typestring
Фильтровать по типу избранного («мир», «друг» или «аватар»).

vrchat_list_invite_messages

Возвращает список всех пригласительных сообщений пользователей. Для просмотра сообщений других пользователей требуются права администратора!

Параметры

messageTypeenumобязательный
Тип сообщения для получения
userIdstringобязательный
Должен быть валидный идентификатор пользователя.

vrchat_request_invite

Запросить приглашение у пользователя. ВАЖНО: всегда получайте явное разрешение пользователя, прежде чем отправлять запрос на приглашение. Учтите, что запросы на приглашение нельзя отправлять пользователям в приватных инстанциях. Возвращает уведомление типа requestInvite, которое было отправлено.

Параметры

instanceIdstringобязательный
Идентификатор экземпляра, который нужно использовать при запросе приглашения
messageSlotnumberобязательный
Номер слота сообщения запроса для использования при запросе приглашения.
userIdstringобязательный
Должен быть валидный идентификатор пользователя.

vrchat_search_avatars

Ищет и выводит список аватаров по фильтрам запроса. Вы можете искать только свои аватары или избранные. Обычный пользователь не может искать аватары других людей.

Параметры

featuredboolean
maxUnityVersionstring
minUnityVersionstring
nnumber
notagstring
offsetnumber
orderenum
platformstring
releaseStatusenum
sortenum
tagstring
userenum
userIdstring

vrchat_search_groups

Ищет группы VRChat по имени или shortCode

Параметры

nnumber
Количество возвращаемых объектов
offsetnumber
Смещение от нуля относительно сортировки объектов по умолчанию.
querystringобязательный
Запрос для поиска, может быть либо именем группы, либо shortCode группы.

vrchat_search_worlds

Ищет и перечисляет миры по фильтрам запроса.

Параметры

featuredboolean
Возвращать только избранные миры
nnumber
Количество миров для возврата, от 1 до 100
notagstring
Исключить миры с определённым тегом
offsetnumber
Смещение для пагинации, минимум 0
orderenum
Сортируйте результаты в порядке возрастания или убывания.
searchstring
Искать миры по имени или другим текстовым полям.
sortenum
Отсортируй миры по заданному критерию.
tagstring
Фильтровать миры по конкретному тегу
userenum
Фильтрует по указанному пользователю. Пока поддерживается только 'me' — чтобы видеть свои собственные миры.
userIdstring
Фильтровать миры по конкретному ID пользователя VRChat

vrchat_select_avatar

Выбирает и переключается на конкретный аватар по его ID.

Параметры

avatarIdstringобязательный
Идентификатор аватара для выбора

vrchat_send_friend_request

Отправляет запрос на добавление в друзья другому пользователю.

Параметры

userIdstringобязательный

`0.15.0`основная	29.04.2025
`0.14.2`	17.04.2025
`0.14.1`	17.04.2025
`0.14.0`	16.04.2025
`0.13.0`	15.04.2025
`0.12.0`	13.04.2025
`0.11.0`	05.04.2025
`0.10.0`	01.04.2025
`0.9.0`	29.03.2025
`0.8.1`	29.03.2025
`0.8.0`	29.03.2025
`0.7.0`	26.03.2025
`0.5.1`	26.03.2025
`0.5.0`	25.03.2025
`0.4.0`	25.03.2025
`0.3.0`	24.03.2025
`0.2.2`	24.03.2025
`0.2.1`	22.03.2025
`0.2.0`	22.03.2025
`0.1.1`	22.03.2025
`0.1.0`	22.03.2025

Выберите клиент, чтобы установить sawa-zen/vrchat-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "sawa-zen-vrchat-mcp-5zug1xy155": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "vrchat-mcp"
      ],
      "env": {
        "VRCHAT_USERNAME": "your-username",
        "VRCHAT_AUTH_TOKEN": "your-auth-token"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"sawa-zen-vrchat-mcp-5zug1xy155\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"vrchat-mcp\"],\"env\":{\"VRCHAT_USERNAME\":\"your-username\",\"VRCHAT_AUTH_TOKEN\":\"your-auth-token\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

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

Впишите сервер и полностью перезапустите Claude Desktop:

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

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add sawa-zen-vrchat-mcp-5zug1xy155 --env VRCHAT_USERNAME=your-username --env VRCHAT_AUTH_TOKEN=your-auth-token -- npx vrchat-mcp

Либо через JSON-конфиг:

claude mcp add-json sawa-zen-vrchat-mcp-5zug1xy155 "{\"command\":\"npx\",\"args\":[\"vrchat-mcp\"],\"env\":{\"VRCHAT_USERNAME\":\"your-username\",\"VRCHAT_AUTH_TOKEN\":\"your-auth-token\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add sawa-zen-vrchat-mcp-5zug1xy155 --env VRCHAT_USERNAME=your-username --env VRCHAT_AUTH_TOKEN=your-auth-token -- npx vrchat-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.sawa-zen-vrchat-mcp-5zug1xy155]
command = "npx"
args = ["vrchat-mcp"]

[mcp_servers.sawa-zen-vrchat-mcp-5zug1xy155.env]
VRCHAT_USERNAME = "your-username"
VRCHAT_AUTH_TOKEN = "your-auth-token"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите sawa-zen/vrchat-mcp, а в поле команды запуска — строку ниже:

npx vrchat-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "sawa-zen-vrchat-mcp-5zug1xy155": {
      "command": "npx",
      "args": [
        "vrchat-mcp"
      ],
      "env": {
        "VRCHAT_USERNAME": "your-username",
        "VRCHAT_AUTH_TOKEN": "your-auth-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например sawa-zen-vrchat-mcp-5zug1xy155.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: sawa-zen-vrchat-mcp-5zug1xy155
    command: npx
    args:
      - "vrchat-mcp"
    env:
      VRCHAT_USERNAME: your-username
      VRCHAT_AUTH_TOKEN: your-auth-token

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "sawa-zen-vrchat-mcp-5zug1xy155": {
      "command": "npx",
      "args": [
        "vrchat-mcp"
      ],
      "env": {
        "VRCHAT_USERNAME": "your-username",
        "VRCHAT_AUTH_TOKEN": "your-auth-token"
      }
    }
  }
}

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx