Servidor MCP para Agent8

Un servidor que implementa el Protocolo de Contexto de Modelo (MCP) para facilitar el desarrollo del SDK de Agent8. Desarrollado con TypeScript y pnpm, compatible con stdio, SSE y transportes con transmisión HTTP.

Características

Este servidor MCP de Agent8 implementa las siguientes capacidades de especificación MCP:

Indicaciones

Solicitud del sistema para Agent8 SDK : proporciona pautas optimizadas para el desarrollo de Agent8 SDK a través de la plantilla de solicitud system-prompt-for-agent8-sdk .

Herramientas

Búsqueda de ejemplos de código : recupera ejemplos de código de desarrollo de juegos de Agent8 relevantes de una base de datos vectorial utilizando la herramienta search_code_examples .
Búsqueda de recursos de juegos : busca recursos de desarrollo de juegos (sprites, animaciones, sonidos, etc.) utilizando coincidencia de similitud semántica a través de la herramienta search_game_resources .
Generación de activos : conjunto de herramientas integral para la creación de activos de juegos:
- Imágenes : Genere recursos de juegos 2D utilizando la herramienta image_asset_generate
- Cinemática : crea secuencias cinematográficas con la herramienta cinematic_asset_generate
- Audio : Genere pistas de música y efectos de sonido con las herramientas music_generate y sfx_generate
- Skyboxes : crea fondos ambientales de 360° con la herramienta skybox_generate
- Herramientas de soporte : Comprobación de estado, recuperación de resultados y utilidades de espera para generación asincrónica

Instalación

# Install dependencies
pnpm install

# Build
pnpm build

Usando Docker

Puede ejecutar esta aplicación usando Docker de varias maneras:

Opción 1: Extraer del Registro de contenedores de GitHub (recomendado)

# 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

Opción 2: Construir localmente

# 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

Configuración del entorno de Docker

Hay tres formas de configurar variables de entorno al ejecutar con Docker:

Usando --env-file (recomendado):
# 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
Uso de indicadores -e individuales:
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
Uso de Docker Compose (para configuración de desarrollo/producción):El proyecto incluye un archivo docker-compose.yml preconfigurado con:
- Asignación automática de puertos desde la configuración .env
- Carga de variables de entorno
- Montaje de volumen para la persistencia de datos
- Política de reinicio automático de contenedores
- Configuración de la comprobación de estado
Para ejecutar el servidor:
docker compose up
Para ejecutar en modo separado:
docker compose up -d

Variables de entorno requeridas:

SUPABASE_URL : URL de Supabase para la conexión a la base de datos
SUPABASE_SERVICE_ROLE_KEY : Clave de rol de servicio de Supabase para autenticación
OPENAI_API_KEY : Clave API de OpenAI para la funcionalidad de IA

El Dockerfile utiliza un proceso de compilación de varias etapas para crear una imagen de producción mínima:

Utiliza Node.js 20 Alpine como imagen base para un tamaño más pequeño
Separa las dependencias de compilación y tiempo de ejecución
Solo incluye los archivos necesarios en la imagen final.
Expone el puerto 3000 por defecto

Uso

Opciones de línea de comandos

# View help
pnpm start --help

# View version information
pnpm start --version

Opciones admitidas:

--debug : Habilitar el modo de depuración
--transport <type> : Tipo de transporte (stdio, sse o streamable-http), predeterminado: stdio
--port <number> : Puerto a utilizar para el transporte SSE o HTTP, predeterminado: 3000
--log-destination <dest> : Destino del registro (stdout, stderr, archivo, ninguno)
--log-file <path> : Ruta al archivo de registro (cuando log-destination es file)
--log-level <level> : Nivel de registro (depuración, información, advertencia, error), predeterminado: información
--env-file <path> : Ruta al archivo .env

Uso de variables de entorno

El servidor admite la configuración mediante variables de entorno, que se pueden configurar directamente o mediante un archivo .env .

Cree un archivo .env en la raíz del proyecto (consulte .env.example como referencia):

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

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

Ejecute el servidor (cargará automáticamente el archivo .env ):

pnpm start

O especifique una ruta personalizada al archivo .env :

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

Prioridad de configuración

El servidor utiliza el siguiente orden de prioridad al determinar los valores de configuración:

Argumentos de la línea de comandos (máxima prioridad)
Variables de entorno (del archivo .env o del entorno del sistema)
Valores predeterminados (prioridad más baja)

Esto le permite establecer la configuración de referencia en su archivo .env y al mismo tiempo anular configuraciones específicas mediante argumentos de la línea de comando cuando sea necesario.

Variables de entorno admitidas

Variable	Descripción	Por defecto
MCP_TRANSPORT	Tipo de transporte (stdio, sse o streamable-http)	estudio
PUERTO	Puerto a utilizar para el transporte SSE	3000
NIVEL DE REGISTRO	Nivel de registro (depuración, información, advertencia, error)	información
DESTINO DEL REGISTRO	Destino del registro (stdout, stderr, archivo, ninguno)	stderr (para transporte stdio), stdout (para transporte sse)
ARCHIVO DE REGISTRO	Ruta al archivo de registro (cuando LOG_DESTINATION es archivo)	(ninguno)
DEPURAR	Habilitar el modo de depuración (verdadero/falso)	FALSO
PUNTO FINAL DE API DE AUTENTICACIÓN V8	URL del punto final de la API de autenticación	(ninguno)
V8_REQUISITO_AUTENTICACIÓN	Requerir autenticación para puntos finales de API	FALSO
URL SUPABASE	URL de Supabase para la conexión a la base de datos	(requerido)
CLAVE DE FUNCIÓN DEL SERVICIO SUPABASE	Clave de rol del servicio Supabase para autenticación	(requerido)
CLAVE API DE OPENAI	Clave API de OpenAI para la funcionalidad de IA	(requerido)
FAL_KEY	Clave API de fal.ai para la generación de activos	(requerido)
CLAVE DE API DE BLOCKADE_LABS	Clave API de Blockade Labs para la generación de skybox	(necesario para la generación de skybox)
V8_ID_CLIENTE_DE_CRÉDITO	ID de cliente para API de consumo de crédito	(ninguno, opcional para la generación de activos)
V8_CLIENTE_DE_CRÉDITO_SECRETO	Secreto de cliente para API de consumo de crédito	(ninguno, opcional para la generación de activos)
PUNTO FINAL DE LA API DE CRÉDITO V8	Punto final de API para consumo de crédito	(requerido para la generación de activos)
HABILITAR TODAS LAS HERRAMIENTAS	Habilitar o deshabilitar todas las herramientas globalmente	verdadero
HABILITAR HERRAMIENTAS DE BÚSQUEDA DE VECTORES	Habilitar o deshabilitar todas las herramientas de búsqueda de vectores	verdadero
HABILITAR HERRAMIENTAS DE GENERACIÓN DE ACTIVOS	Habilitar o deshabilitar todas las herramientas de generación de activos (imágenes, cinemáticas, audio, skyboxes)	verdadero
HABILITAR HERRAMIENTAS DE GENERACIÓN DE IMÁGENES	Habilitar o deshabilitar las herramientas de generación de imágenes	verdadero
HABILITAR HERRAMIENTAS DE GENERACIÓN CINEMÁTICA	Habilitar o deshabilitar herramientas de generación cinematográfica	verdadero
HABILITAR HERRAMIENTAS DE GENERACIÓN DE AUDIO	Habilitar o deshabilitar las herramientas de generación de audio	verdadero
HABILITAR HERRAMIENTAS DE GENERACIÓN DE SKYBOX	Habilitar o deshabilitar las herramientas de generación de skybox	verdadero
HABILITAR HERRAMIENTA DE BÚSQUEDA DE EJEMPLOS DE CÓDIGO	Habilitar o deshabilitar la herramienta de búsqueda de ejemplos de código	verdadero
HABILITAR LA HERRAMIENTA DE BÚSQUEDA DE RECURSOS DEL JUEGO	Habilitar o deshabilitar la herramienta de búsqueda de recursos del juego	verdadero
HABILITAR HERRAMIENTAS DE TEMA DE INTERFAZ DE USUARIO	Habilitar o deshabilitar la herramienta de temas de UI	verdadero

Prioridad de activación de la herramienta : La configuración de activación de la herramienta sigue este orden de prioridad:

Configuraciones de herramientas individuales (por ejemplo, ENABLE_CODE_EXAMPLE_SEARCH_TOOL )
Configuración del tipo de activo (por ejemplo, ENABLE_IMAGE_GENERATION_TOOLS , ENABLE_CINEMATIC_GENERATION_TOOLS )
Configuración del grupo de herramientas (por ejemplo, ENABLE_VECTOR_SEARCH_TOOLS , ENABLE_ASSET_GENERATE_TOOLS )
Configuración de herramientas global ( ENABLE_ALL_TOOLS )

La configuración individual siempre prevalece sobre la configuración del grupo, y la configuración del grupo prevalece sobre la configuración global. Cuando se configuran explícitamente, las configuraciones individuales prevalecen sobre la configuración principal.

Importante : Para habilitar solo herramientas específicas, configure todas las configuraciones de nivel superior como false y habilite únicamente las herramientas que necesite. Este enfoque proporciona una configuración más consistente y predecible.

Ejemplos :

# 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

Uso del transporte de Stdio

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

Uso del transporte SSE

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

Uso del transporte HTTP Streamable

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

Modo de depuración

# Run in debug mode
pnpm start --debug

Indicaciones disponibles

systemprompt-agent8-sdk

Integración de clientes

Uso con Claude Desktop

Agregue lo siguiente al archivo de configuración de Claude Desktop ( claude_desktop_config.json ):

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

Reiniciar Claude Desktop

Agregar nuevos avisos

Agregue nuevas indicaciones al método registerSamplePrompts en el archivo src/prompts/provider.ts .

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Un servidor que implementa el Protocolo de contexto de modelo (MCP) para respaldar el desarrollo del SDK de Agent8 al proporcionar indicaciones del sistema y capacidades de búsqueda de ejemplos de código a través de transportes stdio y SSE.

Related MCP Servers

n8n MCP Server
illuminaresolutions
A
security
A
license
A
quality
An MCP server enabling secure interaction with n8n workflows, executions, and settings via the Model Context Protocol, designed for integration with Large Language Models (LLMs).
Last updated -
33
65
34
TypeScript
MIT License
MCP Shell Server
mkusaka
A
security
A
license
A
quality
A server that uses the Model Context Protocol (MCP) to allow AI agents to safely execute shell commands on a host system.
Last updated -
1
76
2
TypeScript
MIT License
Hello World MCP Server
jageenshukla
-
security
A
license
-
quality
A demonstration server that implements the Model Context Protocol (MCP) SDK, providing tools and endpoints for server-sent events and message handling.
Last updated -
27
TypeScript
MIT License
Xava Labs MCP Template
xava-labs
-
security
A
license
-
quality
A template repository for building Model Context Protocol (MCP) servers that enables developers to create interactive AI agents with real-time bidirectional communication capabilities through WebSocket and SSE endpoints.
Last updated -
TypeScript
MIT License

View all related MCP servers

MCP Server for Agent8