trident-mcp

trident-mcp — это MCP-сервер на Go для генерации и постобработки 3D-моделей с помощью ИИ.

Сервер не зависит от клиента и работает автономно с любым MCP-совместимым клиентом. Вам не нужны дополнительные навыки или другие MCP-серверы для использования основных инструментов генерации 3D, опроса состояния, загрузки и постобработки.

В настоящее время он поставляется с провайдером Tripo и предоставляет инструменты для:

• генерации 3D из текста

• генерации 3D из изображения

• генерации 3D из мультивида

• асинхронного опроса задач

• загрузки моделей

• ретопологии

• конвертации форматов

• стилизации

• просмотра каталога моделей и конфигурации сервера

Требования

• Go 1.25+

• API-ключ Tripo в переменной TRIPO_API_KEY

Установка

Сборка локально:

go build ./cmd/trident-mcp

Или установка с помощью Go:

go install github.com/mordor-forge/trident-mcp/cmd/trident-mcp@latest

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

Сервер считывает конфигурацию из переменных окружения:

Запуск

Сервер общается по протоколу MCP через stdio:

TRIPO_API_KEY=tsk_your_key_here trident-mcp

Пример конфигурации MCP-клиента:

{
  "mcpServers": {
    "trident-mcp": {
      "command": "trident-mcp",
      "env": {
        "TRIPO_API_KEY": "tsk_your_key_here",
        "MODEL_OUTPUT_DIR": "/absolute/path/to/generated_models"
      }
    }
  }
}

Инструменты

Генерация

• text_to_3d

• image_to_3d

• multiview_to_3d

Эти инструменты запускают асинхронные задачи. Используйте task_status для проверки завершения, а затем download_model для получения результата задачи.

Статус и загрузка

• task_status

• download_model

download_model сохраняет фактический формат вывода задачи. Если вам нужен другой формат, сначала запустите convert_format, а затем загрузите задачу конвертации.

Постобработка

• retopologize

• convert_format

• stylize

Интроспекция

• list_models

• get_config

get_config сообщает активный бэкенд, выходную директорию и версию сервера.

Навыки

Репозиторий также включает сопутствующие навыки агента в папке skills/:

• skills/3d-gen/SKILL.md

• skills/multiview-3d/SKILL.md

• skills/3d-to-blender/SKILL.md

Эти навыки являются опциональными. Сам MCP-сервер отлично работает самостоятельно в любом MCP-клиенте.

Некоторые из сопутствующих навыков предназначены для объединения trident-mcp с gemini-media-mcp для создания более полного автоматизированного конвейера. В такой конфигурации gemini-media-mcp может помочь с генерацией идей, созданием референсных изображений и изображений с разных ракурсов, в то время как trident-mcp берет на себя реконструкцию и постобработку. Такая связка обеспечивает более полный процесс от идеи до готовой 3D-модели.

Разработка

Запуск локальных проверок:

go test ./...
go vet ./...

Также существует опциональный E2E smoke-тест для проверки загрузки в Tripo:

TRIPO_API_KEY=tsk_your_key_here go test -tags=e2e -run "TestE2E_" ./internal/provider/tripo/ -v

Релиз

GitHub Actions запускает модульные проверки при пушах и pull-запросах, а также выполняет E2E smoke-тест в ветке main и при создании тегов версий. Релизные сборки создаются с помощью GoReleaser.

Артефакты помечаются версией релиза, чтобы метаданные бинарного файла и реализации MCP оставались синхронизированными.