MCP-сервер для Agent8

Сервер, реализующий протокол контекста модели (MCP) для поддержки разработки Agent8 SDK. Разработан с использованием TypeScript и pnpm, поддерживает транспорты stdio и SSE.

Функции

Этот сервер MCP Agent8 реализует следующие возможности спецификации MCP:

Подсказки

Системный запрос для Agent8 SDK : предоставляет оптимизированные рекомендации по разработке Agent8 SDK с помощью шаблона запроса system-prompt-for-agent8-sdk .

Инструменты

Поиск примеров кода : извлекает соответствующие примеры кода разработки игры Agent8 из векторной базы данных с помощью инструмента search_code_examples .
Поиск игровых ресурсов : поиск ресурсов для разработки игр (спрайты, анимация, звуки и т. д.) с использованием сопоставления семантического сходства с помощью инструмента search_game_resources .
Генерация ресурсов : комплексный набор инструментов для создания игровых ресурсов:
- Изображения : создание 2D-ресурсов игры с помощью инструмента image_asset_generate
- Кинематография : создание кинематографических последовательностей с помощью инструмента cinematic_asset_generate
- Аудио : создание музыкальных треков и звуковых эффектов с помощью инструментов music_generate и sfx_generate
- Skyboxes : создание 360° фонов окружающей среды с помощью инструмента skybox_generate
- Инструменты поддержки : проверка состояния, извлечение результатов и утилиты ожидания для асинхронной генерации.

Установка

# Install dependencies
pnpm install

# Build
pnpm build

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

Вы можете запустить это приложение с помощью Docker несколькими способами:

Вариант 1: Извлечение из реестра контейнеров GitHub (рекомендуется)

# Pull the latest image
docker pull ghcr.io/planetarium/mcp-agent8:latest

# Run the container
docker run -p 3333:3333 --env-file .env ghcr.io/planetarium/mcp-agent8:latest

Вариант 2: Сборка локально

# Build the Docker image
docker build -t agent8-mcp-server .

# Run the container with environment variables
docker run -p 3333:3333 --env-file .env agent8-mcp-server

Конфигурация среды Docker

Существует три способа настройки переменных среды при работе с Docker:

Использование --env-file (рекомендуется):
# Create and configure your .env file first cp .env.example .env nano .env # Run with .env file docker run -p 3000:3000 --env-file .env agent8-mcp-server
Использование отдельных флагов -e :
docker run -p 3000:3000 \ -e SUPABASE_URL=your_supabase_url \ -e SUPABASE_SERVICE_ROLE_KEY=your_service_role_key \ -e OPENAI_API_KEY=your_openai_api_key \ -e MCP_TRANSPORT=sse \ -e PORT=3000 \ -e LOG_LEVEL=info \ agent8-mcp-server
Использование Docker Compose (для разработки/настройки производства):Проект включает предварительно настроенный файл docker-compose.yml со следующим содержимым:
- Автоматическое сопоставление портов из конфигурации .env
- Загрузка переменных среды
- Монтирование тома для сохранения данных
- Политика автоматического перезапуска контейнера
- Конфигурация проверки работоспособности
Для запуска сервера:
docker compose up
Для работы в отсоединенном режиме:
docker compose up -d

Требуемые переменные среды:

SUPABASE_URL : URL-адрес Supabase для подключения к базе данных
SUPABASE_SERVICE_ROLE_KEY : ключ роли службы Supabase для аутентификации
OPENAI_API_KEY : ключ API OpenAI для функциональности ИИ

Dockerfile использует многоэтапный процесс сборки для создания минимального производственного образа:

Использует Node.js 20 Alpine в качестве базового образа для меньшего размера
Разделяет зависимости сборки и времени выполнения
Включает только необходимые файлы в конечное изображение
По умолчанию открывает порт 3000

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

Параметры командной строки

# View help
pnpm start --help

# View version information
pnpm start --version

Поддерживаемые параметры:

--debug : Включить режим отладки
--transport <type> : Тип транспорта (stdio или sse), по умолчанию: stdio
--port <number> : Порт, используемый для транспорта SSE, по умолчанию: 3000
--log-destination <dest> : Место назначения журнала (stdout, stderr, файл, нет)
--log-file <path> : Путь к файлу журнала (если log-destination — файл)
--log-level <level> : Уровень журнала (отладка, информация, предупреждение, ошибка), по умолчанию: информация
--env-file <path> : Путь к файлу .env

Использование переменных среды

Сервер поддерживает настройку через переменные среды, которые можно задать напрямую или через файл .env .

Создайте файл .env в корне проекта (см. .env.example для справки):

# Copy the example file
cp .env.example .env

# Edit the .env file with your settings
nano .env

Запустите сервер (он автоматически загрузит файл .env ):

pnpm start

Или укажите собственный путь к файлу .env :

pnpm start --env-file=/path/to/custom/.env

Приоритет конфигурации

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

Аргументы командной строки (наивысший приоритет)
Переменные среды (из файла .env или системной среды)
Значения по умолчанию (самый низкий приоритет)

Это позволяет вам задать базовую конфигурацию в файле .env , при необходимости переопределяя определенные настройки с помощью аргументов командной строки.

Поддерживаемые переменные среды

Переменная	Описание	По умолчанию
MCP_ТРАНСПОРТ	Тип транспорта (stdio или sse)	стдио
ПОРТ	Порт, используемый для транспорта SSE	3000
УРОВЕНЬ_ЛОГА	Уровень журнала (отладка, информация, предупреждение, ошибка)	информация
LOG_DESTINATION	Место назначения журнала (stdout, stderr, файл, нет)	stderr (для транспорта stdio), stdout (для транспорта sse)
ФАЙЛ_ЖУРНАЛА	Путь к файлу журнала (когда LOG_DESTINATION — файл)	(никто)
ОТЛАЖИВАТЬ	Включить режим отладки (true/false)	ЛОЖЬ
V8_AUTH_API_ENDPOINT	URL конечной точки API аутентификации	(никто)
V8_AUTH_REQUIRE	Требовать аутентификацию для конечных точек API	ЛОЖЬ
SUPABASE_URL	Supabase URL для подключения к базе данных	(необходимый)
SUPABASE_SERVICE_ROLE_KEY	Ключ роли сервиса Supabase для аутентификации	(необходимый)
ОТКРЫТЫЙ_API_КЛЮЧ	Ключ API OpenAI для функциональности ИИ	(необходимый)
FAL_KEY	API-ключ fal.ai для генерации активов	(необходимый)
BLOCKADE_LABS_API_KEY	Ключ API Blockade Labs для генерации скайбокса	(требуется для генерации скайбокса)
V8_CREDIT_CLIENT_ID	Идентификатор клиента для API потребления кредита	(нет, необязательно для генерации активов)
V8_CREDIT_CLIENT_SECRET	Секрет клиента для API потребления кредита	(нет, необязательно для генерации активов)
V8_CREDIT_API_ENDPOINT	Конечная точка API для потребления кредита	(требуется для генерации активов)
ВКЛЮЧИТЬ_ВСЕ_ИНСТРУМЕНТЫ	Включить или отключить все инструменты глобально	истинный
ВКЛЮЧИТЬ_ВЕКТОРНЫЕ_СРЕДСТВА_ПОИСКА	Включить или отключить все инструменты поиска векторов	истинный
ВКЛЮЧИТЬ_АКТИВ_ГЕНЕРИРОВАТЬ_ИНСТРУМЕНТЫ	Включить или отключить все инструменты генерации ресурсов (изображения, кинематография, аудио, скайбоксы)	истинный
ВКЛЮЧИТЬ_ИНСТРУМЕНТЫ_ГЕНЕРАЦИИ_ИЗОБРАЖЕНИЙ	Включить или отключить инструменты генерации изображений	истинный
ВКЛЮЧИТЬ_ИНСТРУМЕНТЫ_ГЕНЕРАЦИИ_КИНЕМАТОГРАФИИ	Включить или отключить инструменты создания кинематографического контента	истинный
ВКЛЮЧИТЬ_ИНСТРУМЕНТЫ_ГЕНЕРАЦИИ_АУДИО	Включить или отключить инструменты генерации звука	истинный
ВКЛЮЧИТЬ_SKYBOX_GENERATION_TOOLS	Включить или отключить инструменты генерации скайбокса	истинный
ВКЛЮЧИТЬ_КОД_ПРИМЕР_ПОИСКА_ИНСТРУМЕНТА	Включить или отключить инструмент поиска примеров кода	истинный
ВКЛЮЧИТЬ_ИНСТРУМЕНТ_ПОИСКА_РЕСУРСОВ_ИГРЫ	Включить или отключить инструмент поиска игровых ресурсов	истинный
ВКЛЮЧИТЬ_ТЕМУ_UI_ИНСТРУМЕНТЫ	Включить или отключить инструмент темы пользовательского интерфейса	истинный

Приоритет активации инструмента : Настройки активации инструмента имеют следующий порядок приоритета:

Индивидуальные настройки инструмента (например, ENABLE_CODE_EXAMPLE_SEARCH_TOOL )
Настройки типа актива (например, ENABLE_IMAGE_GENERATION_TOOLS , ENABLE_CINEMATIC_GENERATION_TOOLS )
Настройки группы инструментов (например, ENABLE_VECTOR_SEARCH_TOOLS , ENABLE_ASSET_GENERATE_TOOLS )
Глобальная настройка инструмента ( ENABLE_ALL_TOOLS )

Индивидуальные настройки всегда переопределяют групповые настройки, а групповые настройки переопределяют глобальные настройки. Когда индивидуальные настройки заданы явно, они имеют приоритет над родительскими настройками.

Важно : Чтобы включить только определенные инструменты, вам следует установить все настройки более высокого уровня на false и включить только те инструменты, которые вам нужны. Такой подход обеспечивает более последовательную и предсказуемую конфигурацию.

Примеры :

# Enable only vector search tools
ENABLE_ALL_TOOLS=false
ENABLE_VECTOR_SEARCH_TOOLS=true

# Enable only image generation tool, disable all others
ENABLE_ALL_TOOLS=false
ENABLE_ASSET_GENERATE_TOOLS=false
ENABLE_IMAGE_GENERATION_TOOLS=true

# Enable only code example search tool, disable all others
ENABLE_ALL_TOOLS=false
ENABLE_VECTOR_SEARCH_TOOLS=false
ENABLE_CODE_EXAMPLE_SEARCH_TOOL=true

# Enable only cinematic and audio generation tools
ENABLE_ALL_TOOLS=false
ENABLE_ASSET_GENERATE_TOOLS=false
ENABLE_CINEMATIC_GENERATION_TOOLS=true
ENABLE_AUDIO_GENERATION_TOOLS=true

Использование Stdio-транспорта

# Build and run
pnpm build
pnpm start --transport=stdio

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

# Build and run (default port: 3000)
pnpm build
pnpm start --transport=sse --port=3000

Режим отладки

# Run in debug mode
pnpm start --debug

Доступные подсказки

systemprompt-agent8-sdk

Интеграция клиента

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

Добавьте следующее в файл конфигурации Claude Desktop ( claude_desktop_config.json ):

{
  "mcpServers": {
    "Agent8": {
      "command": "npx",
      "args": ["--yes", "agent8-mcp-server"]
    }
  }
}

Перезагрузить рабочий стол Клода

Добавление новых подсказок

Добавьте новые подсказки в метод registerSamplePrompts в файле src/prompts/provider.ts .

Лицензия

Массачусетский технологический институт

MCP Server for Agent8

Integrations