MCP-сервер Tripo AI

Это сервер протокола контекста модели (MCP) для API Tripo3D AI. Он позволяет ИИ-ассистентам использовать возможности генерации 3D-моделей от Tripo.

Функции

• Текст в 3D: Генерация 3D-моделей по текстовым запросам.

• Изображение в 3D: Генерация 3D-моделей по изображениям (поддерживаются локальные пути, URL-адреса или предварительно загруженные токены).

• Многоракурсные изображения в 3D: Генерация 3D-моделей по нескольким изображениям с разных ракурсов (локальные пути, URL-адреса или токены).

• Улучшение модели: Повышение качества черновой модели.

• Стилизация: Применение стилей (lego, voxel, voronoi, minecraft) к модели.

• Текстурирование модели: Повторное текстурирование существующей модели, опционально с использованием текстового или графического запроса.

• Конвертация модели: Экспорт модели в другой формат (GLTF, FBX, OBJ, STL, USDZ, 3MF).

• Рабочий процесс анимации: Проверка возможности риггинга → риггинг модели → перенос предустановленной анимации.

• Статус задачи: Проверка статуса и получение URL-адресов вывода любой задачи генерации.

• Загрузка файла: Загрузка локального файла изображения и получение токена файла для повторного использования.

Related MCP server: Tripo3D MCP

Установка

npm install -g tripo-ai-mcp-server

Конфигурация

Вам потребуется секретный ключ API Tripo3D. Вы можете задать его в файле .env или передать как переменную окружения TRIPO_API_SECRET.

Конфигурация клиента

Claude Desktop

Добавьте следующее в ваш claude_desktop_config.json (обычно находится по пути %APPDATA%\Claude\claude_desktop_config.json в Windows или ~/Library/Application Support/Claude/claude_desktop_config.json в macOS):

{
  "mcpServers": {
    "tripo-ai": {
      "command": "npx",
      "args": [
        "-y",
        "tripo-ai-mcp-server"
      ],
      "env": {
        "TRIPO_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

Использование

Запустите сервер:

tripo-ai-mcp-server

Инструменты

• text_to_3d: Генерация 3D-модели по текстовому описанию.

• image_to_3d: Генерация 3D-модели по изображению (локальный путь, URL или предварительно загруженный токен).

• multiview_to_3d: Генерация 3D-модели по нескольким изображениям с разных ракурсов.

• get_task_status: Проверка статуса задачи и получение URL-адресов выходных моделей.

• upload_file: Загрузка локального файла изображения и получение токена файла для повторного использования.

• refine_model: Улучшение черновой модели для повышения качества.

• animate_prerigcheck: Проверка пригодности модели для риггинга.

• rig_model: Риггинг модели для возможности её анимации.

• retarget_animation: Применение предустановленной анимации к риггированной модели.

• stylize_model: Применение визуального стиля к модели (lego, voxel, voronoi, minecraft).

• convert_model: Конвертация модели в другой формат файла (GLTF, FBX, OBJ, STL, USDZ, 3MF).

• texture_model: Генерация новых текстур для существующей модели.

Разработка

1. Клонируйте репозиторий.

2. npm install

3. npm run build

4. node dist/index.js

Публикация в npm

Рабочий процесс GitHub Actions (.github/workflows/publish.yml) автоматически публикует пакет в npm при создании нового релиза на GitHub.

Однократная настройка:

1. Создайте Automation токен npm на npmjs.com → Аватар → Access Tokens → Generate New Token → Automation.

2. Добавьте его как секрет репозитория в GitHub: Settings → Secrets and variables → Actions → New repository secret → назовите его NPM_TOKEN.

Для выпуска новой версии:

1. Увеличьте версию в поле "version" в файле package.json.

2. Закоммитьте и отправьте изменения (push).

3. Создайте новый релиз на GitHub (пометьте его версией, например v1.1.0). Рабочий процесс запустится автоматически и опубликует пакет в npm.

Лицензия

ISC