three.ws Avatars — MCP-сервер для Claude Code: функции и запуск
Интегрирует интерактивные трёхмерные аватары прямо в окно чата и генерирует код вставки для сторонних страниц. Работает без ключа API для публичных моделей.
claude mcp add --env THREEWS_BASE_URL=<THREEWS_BASE_URL> --transport stdio threews-avatar-mcp -- npx -y @three-ws/avatar-mcpЧто делает three.ws Avatars
MCP-сервер подключает агент к сервису three.ws в режиме чтения. При обработке запросов клиент получает графическое превью, ссылку на веб-ресурс и интерактивный элемент <model-viewer>. В средах с поддержкой стандарта MCP Apps трёхмерную модель можно свободно вращать и масштабировать прямо посреди переписки.
Внутри заложены три инструмента: render_avatar, avatar_embed_code и get_avatar. Персонажа определяют по идентификатору UUID, пользовательскому юзернейму или прямой ссылке на файл GLB. Запрос avatar_embed_code формирует готовый тег <iframe> с настройкой фона, габаритов и режима зацикливания базовой анимации.
Публичные модели не требуют токена авторизации. Все операции обращаются к реальным эндпоинтам three.ws. Если вам нужен тестовый контур или альтернативный сервер, придётся передать переменную окружения THREEWS_BASE_URL при запуске.
Какие задачи решает
- вывести интерактивную трёхмерную модель в диалог с агентом
- сгенерировать код тега
<iframe>для вставки аватара на сайт - получить метаданные и прямую ссылку на GLB-файл персонажа
- настроить ракурс и фон отображения 3D-аватара
Примеры запросов агенту
- Покажи в чате аватар пользователя @alex с тёмным фоном и автоматическим вращением.
- Сгенерируй код iframe для аватара с id bf58f7fc-64b3-4a92-8c27-dd472fc04b58 высотой 400 пикселей.
- Запроси ссылку на модель GLB и статус видимости для аватара three.ws.
Как установить three.ws Avatars
Командой платформы
claude mcp add --env THREEWS_BASE_URL=<THREEWS_BASE_URL> --transport stdio threews-avatar-mcp -- npx -y @three-ws/avatar-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add threews-avatar-mcp --env THREEWS_BASE_URL=<THREEWS_BASE_URL> -- npx -y @three-ws/avatar-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"threews-avatar-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/avatar-mcp"
],
"env": {
"THREEWS_BASE_URL": "<THREEWS_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"threews-avatar-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/avatar-mcp"
],
"env": {
"THREEWS_BASE_URL": "<THREEWS_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e THREEWS_BASE_URL=<THREEWS_BASE_URL> threews-avatar-mcp npx -y @three-ws/avatar-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о three.ws Avatars
Как установить three.ws Avatars в Claude Code?
Выполните в терминале команду claude mcp add threews-avatar -- npx -y @three-ws/avatar-mcp.
Нужен ли ключ API для вызова трёхмерных моделей?
Нет, публичные и скрытые аватары отдаются без авторизации и ключей API.
Что возвращает инструмент render_avatar?
Инструмент отдаёт превью-картинку, ссылку для встраивания и интерактивный блок <model-viewer> для клиентов с поддержкой MCP Apps.
