3D AI Agent Avatar — MCP-сервер для Claude Code: запуск
Сервер анализирует и сжимает файлы GLB, а также создаёт 3D-аватаров с голосом OpenAI и кошельком Solana.
claude mcp add 3d-ai-agent-avatar -e HELIUS_API_KEY=<HELIUS_API_KEY> -e NVIDIA_API_KEY=<NVIDIA_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e REPLICATE_API_TOKEN=<REPLICATE_API_TOKEN> -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/avatar-agentЧто делает 3D AI Agent Avatar
MCP-сервер совмещает инструменты трёхмерной графики и среду для автономного персонажа. Для работы с файлами GLB и glTF доступны проверка по спецификации Khronos через gltf-validator, очистка сеток и сжатие Draco с помощью библиотеки @gltf-transform/core. Сервер сразу отдаёт отчёт об изменении размера модели и формирует превью в PNG.
Второй блок отвечает за интерактивного аватара. Персонаж озвучивает текст через синтез OpenAI TTS, держит кошелёк в сети Solana и отправляет запросы на платформу pump.fun. Для проверки 3D-файлов ключи доступа не нужны. Транзакции на блокчейне меняют реальный баланс кошелька, поэтому клиент запросит подтверждение перед запуском таких команд.
Какие задачи решает
- проверить модель GLB на ошибки спецификации Khronos
- сжать трёхмерную сетку алгоритмом Draco и убрать дубликаты
- сгенерировать превью-снимок или ссылку на 3D-просмотрщик
- создать говорящего 3D-аватара с кошельком в сети Solana
Примеры запросов агенту
- Проверь файл
avatar.glbчерез официальный валидатор и выведи число полигонов. - Оптимизируй модель
model.glbсо сжатием Draco и покажи разницу в байтах. - Создай для персонажа кошелёк Solana с префиксом
threeи озвучь реплику с помощью OpenAI TTS.
Как установить 3D AI Agent Avatar
Командой платформы
claude mcp add 3d-ai-agent-avatar -e HELIUS_API_KEY=<HELIUS_API_KEY> -e NVIDIA_API_KEY=<NVIDIA_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e REPLICATE_API_TOKEN=<REPLICATE_API_TOKEN> -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/avatar-agentВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
codex mcp add avatar-agent-mcp --env SOLANA_RPC_URL=<SOLANA_RPC_URL> --env ETH_RPC_URL=<ETH_RPC_URL> --env HELIUS_API_KEY=<HELIUS_API_KEY> --env NVIDIA_API_KEY=<NVIDIA_API_KEY> --env OPENAI_API_KEY=<OPENAI_API_KEY> -- npx -y @three-ws/avatar-agentВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"avatar-agent-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/avatar-agent"
],
"env": {
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"ETH_RPC_URL": "<ETH_RPC_URL>",
"HELIUS_API_KEY": "<HELIUS_API_KEY>",
"NVIDIA_API_KEY": "<NVIDIA_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"avatar-agent-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/avatar-agent"
],
"env": {
"SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
"ETH_RPC_URL": "<ETH_RPC_URL>",
"HELIUS_API_KEY": "<HELIUS_API_KEY>",
"NVIDIA_API_KEY": "<NVIDIA_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e SOLANA_RPC_URL=<SOLANA_RPC_URL> -e ETH_RPC_URL=<ETH_RPC_URL> -e HELIUS_API_KEY=<HELIUS_API_KEY> -e NVIDIA_API_KEY=<NVIDIA_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> avatar-agent-mcp npx -y @three-ws/avatar-agentВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о 3D AI Agent Avatar
Как установить 3D AI Agent Avatar в Claude Code?
Выполните в терминале команду `claude mcp add 3d-ai-agent-avatar -e HELIUS_API_KEY=<HELIUS_API_KEY> -e NVIDIA_API_KEY=<NVIDIA_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e REPLICATE_API_TOKEN=<REPLICATE_API_TOKEN> -e SOLANA_SECRET_KEY=<SOLANA_SECRET_KEY> -- npx -y @three-ws/avatar-agent`. Замените плейсхолдеры в угловых скобках на свои ключи.
Какие функции работают без ключей API?
Инструменты валидации, сжатия GLB, создания превью и снимков pump.fun не требуют переменных окружения и запускаются сразу.
Безопасно ли запускать финансовые операции с кошелька?
Инструменты переводов и покупки токенов помечены флагом destructiveHint: true. Совместимый клиент запросит подтверждение перед отправкой транзакции в сеть Solana.
