MCP-Server für Agent8

Ein Server, der das Model Context Protocol (MCP) implementiert, um die Entwicklung des Agent8 SDK zu unterstützen. Entwickelt mit TypeScript und pnpm, unterstützt stdio- und SSE-Transporte.

Merkmale

Dieser Agent8 MCP-Server implementiert die folgenden MCP-Spezifikationsfunktionen:

Eingabeaufforderungen

Systemaufforderung für Agent8 SDK : Bietet optimierte Richtlinien für die Agent8 SDK-Entwicklung über die Eingabeaufforderungsvorlage system-prompt-for-agent8-sdk .

Werkzeuge

Suche nach Codebeispielen : Ruft mithilfe des Tools search_code_examples relevante Codebeispiele für die Agent8-Spieleentwicklung aus einer Vektordatenbank ab.
Suche nach Spielressourcen : Sucht nach Spielentwicklungsressourcen (Sprites, Animationen, Sounds usw.) mithilfe des semantischen Ähnlichkeitsabgleichs über das Tool search_game_resources .
Asset-Generierung : Umfassendes Toolset zur Erstellung von Spiel-Assets:
- Bilder : Generieren Sie 2D-Spiel-Assets mit dem Tool image_asset_generate
- Kinematik : Erstellen Sie Filmsequenzen mit dem Tool cinematic_asset_generate
- Audio : Generieren Sie Musiktitel und Soundeffekte mit den Tools music_generate und sfx_generate
- Skyboxen : Erstellen Sie 360°-Umgebungshintergründe mit dem Tool skybox_generate
- Support-Tools : Statusprüfung, Ergebnisabruf und Warteprogramme für die asynchrone Generierung

Installation

# Install dependencies
pnpm install

# Build
pnpm build

Verwenden von Docker

Sie können diese Anwendung mit Docker auf verschiedene Arten ausführen:

Option 1: Aus GitHub Container Registry abrufen (empfohlen)

# 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

Option 2: Lokal erstellen

# 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

Konfiguration der Docker-Umgebung

Es gibt drei Möglichkeiten, Umgebungsvariablen bei der Ausführung mit Docker zu konfigurieren:

Verwenden von --env-file (empfohlen):
# 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
Verwenden einzelner -e -Flags:
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
Verwenden von Docker Compose (für Entwicklungs-/Produktions-Setup):Das Projekt enthält eine vorkonfigurierte Datei docker-compose.yml mit:
- Automatische Portzuordnung aus der .env-Konfiguration
- Laden von Umgebungsvariablen
- Volume-Mounting für Datenpersistenz
- Richtlinie zum automatischen Neustarten von Containern
- Integritätsprüfungskonfiguration
So führen Sie den Server aus:
docker compose up
So führen Sie den getrennten Modus aus:
docker compose up -d

Erforderliche Umgebungsvariablen:

SUPABASE_URL : Supabase-URL für die Datenbankverbindung
SUPABASE_SERVICE_ROLE_KEY : Supabase-Servicerollenschlüssel zur Authentifizierung
OPENAI_API_KEY : OpenAI-API-Schlüssel für KI-Funktionalität

Das Dockerfile verwendet einen mehrstufigen Build-Prozess, um ein minimales Produktionsimage zu erstellen:

Verwendet Node.js 20 Alpine als Basisimage für kleinere Größen
Trennt Build- und Laufzeitabhängigkeiten
Schließt nur die erforderlichen Dateien in das endgültige Bild ein
Stellt standardmäßig Port 3000 bereit

Verwendung

Befehlszeilenoptionen

# View help
pnpm start --help

# View version information
pnpm start --version

Unterstützte Optionen:

--debug : Debug-Modus aktivieren
--transport <type> : Transporttyp (stdio oder sse), Standard: stdio
--port <number> : Für den SSE-Transport zu verwendender Port, Standard: 3000
--log-destination <dest> : Protokollziel (stdout, stderr, Datei, keine)
--log-file <path> : Pfad zur Protokolldatei (wenn das Protokollziel eine Datei ist)
--log-level <level> : Protokollebene (Debug, Info, Warnen, Fehler), Standard: Info
--env-file <path> : Pfad zur .env-Datei

Verwenden von Umgebungsvariablen

Der Server unterstützt die Konfiguration über Umgebungsvariablen, die direkt oder über eine .env Datei festgelegt werden können.

Erstellen Sie eine .env Datei im Projektstamm (siehe .env.example als Referenz):

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

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

Führen Sie den Server aus (die .env Datei wird automatisch geladen):

pnpm start

Oder geben Sie einen benutzerdefinierten Pfad zur .env Datei an:

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

Konfigurationspriorität

Der Server verwendet beim Bestimmen der Konfigurationswerte die folgende Prioritätsreihenfolge:

Befehlszeilenargumente (höchste Priorität)
Umgebungsvariablen (aus .env Datei oder der Systemumgebung)
Standardwerte (niedrigste Priorität)

Auf diese Weise können Sie die Basiskonfiguration in Ihrer .env Datei festlegen und gleichzeitig bestimmte Einstellungen bei Bedarf über Befehlszeilenargumente überschreiben.

Unterstützte Umgebungsvariablen

Variable	Beschreibung	Standard
MCP_TRANSPORT	Transporttyp (stdio oder sse)	stdio
HAFEN	Für den SSE-Transport zu verwendender Port	3000
LOG_LEVEL	Protokollebene (Debug, Info, Warnung, Fehler)	Info
LOG_DESTINATION	Protokollziel (stdout, stderr, Datei, keine)	stderr (für stdio-Transport), stdout (für sse-Transport)
LOG_FILE	Pfad zur Protokolldatei (wenn LOG_DESTINATION eine Datei ist)	(keiner)
DEBUGGEN	Debug-Modus aktivieren (true/false)	FALSCH
V8_AUTH_API_ENDPOINT	URL des Authentifizierungs-API-Endpunkts	(keiner)
V8_AUTH_REQUIRE	Authentifizierung für API-Endpunkte erforderlich	FALSCH
SUPABASE_URL	Supabase-URL für die Datenbankverbindung	(erforderlich)
SUPABASE_SERVICE_ROLE_KEY	Supabase-Dienstrollenschlüssel zur Authentifizierung	(erforderlich)
OPENAI_API_KEY	OpenAI-API-Schlüssel für KI-Funktionalität	(erforderlich)
FAL_KEY	fal.ai API-Schlüssel zur Asset-Generierung	(erforderlich)
BLOCKADE_LABS_API_KEY	Blockade Labs API-Schlüssel zur Skybox-Generierung	(erforderlich für die Skybox-Generierung)
V8_CREDIT_CLIENT_ID	Client-ID für die API zur Kreditnutzung	(keine, optional für die Asset-Generierung)
V8_CREDIT_CLIENT_SECRET	Clientgeheimnis für die API zur Kreditnutzung	(keine, optional für die Asset-Generierung)
V8_CREDIT_API_ENDPOINT	API-Endpunkt für den Kreditverbrauch	(erforderlich für die Asset-Generierung)
ALLE WERKZEUGE AKTIVIEREN	Alle Tools global aktivieren oder deaktivieren	WAHR
Vektorsuchwerkzeuge aktivieren	Aktivieren oder deaktivieren Sie alle Vektorsuchwerkzeuge	WAHR
AKTIVIEREN_ASSET_GENERATE_TOOLS	Aktivieren oder deaktivieren Sie alle Tools zur Asset-Generierung (Bilder, Filmsequenzen, Audio, Skyboxen).	WAHR
AKTIVIEREN_DER_BILDERSTELLUNGSWERKZEUGE	Aktivieren oder Deaktivieren von Bildgenerierungstools	WAHR
AKTIVIEREN_CINEMATIC_GENERATION_TOOLS	Aktivieren oder Deaktivieren von Filmgenerierungstools	WAHR
AUDIOGENERIERUNGSTOOLS AKTIVIEREN	Aktivieren oder Deaktivieren von Tools zur Audiogenerierung	WAHR
Werkzeuge zur Skybox-Erstellung aktivieren	Aktivieren oder Deaktivieren von Tools zur Skybox-Generierung	WAHR
AKTIVIEREN_CODE_BEISPIEL_SUCHTOOL	Aktivieren oder Deaktivieren des Suchtools für Codebeispiele	WAHR
Suchtool für Spielressourcen aktivieren	Aktivieren oder Deaktivieren des Suchtools für Spielressourcen	WAHR
ENABLE_UI_THEME_TOOLS	Aktivieren oder Deaktivieren des UI-Designtools	WAHR

Priorität der Tool-Aktivierung : Die Einstellungen für die Tool-Aktivierung folgen dieser Prioritätsreihenfolge:

Individuelle Tool-Einstellungen (zB ENABLE_CODE_EXAMPLE_SEARCH_TOOL )
Asset-Typ-Einstellungen (z. B. ENABLE_IMAGE_GENERATION_TOOLS , ENABLE_CINEMATIC_GENERATION_TOOLS )
Werkzeuggruppeneinstellungen (z. B. ENABLE_VECTOR_SEARCH_TOOLS , ENABLE_ASSET_GENERATE_TOOLS )
Globale Werkzeugeinstellung ( ENABLE_ALL_TOOLS )

Individuelle Einstellungen haben immer Vorrang vor Gruppeneinstellungen, und Gruppeneinstellungen haben Vorrang vor globalen Einstellungen. Wenn individuelle Einstellungen explizit festgelegt werden, haben sie Vorrang vor den übergeordneten Einstellungen.

Wichtig : Um nur bestimmte Tools zu aktivieren, sollten Sie alle übergeordneten Einstellungen auf false setzen und nur die benötigten Tools aktivieren. Dieser Ansatz sorgt für eine konsistentere und vorhersehbarere Konfiguration.

Beispiele :

# 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

Verwenden von Stdio Transport

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

Verwenden des SSE-Transports

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

Debug-Modus

# Run in debug mode
pnpm start --debug

Verfügbare Eingabeaufforderungen

systemprompt-agent8-sdk

Client-Integration

Verwendung mit Claude Desktop

Fügen Sie der Claude Desktop-Konfigurationsdatei ( claude_desktop_config.json ) Folgendes hinzu:

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

Starten Sie Claude Desktop neu

Neue Eingabeaufforderungen hinzufügen

Fügen Sie der Methode registerSamplePrompts in der Datei src/prompts/provider.ts neue Eingabeaufforderungen hinzu.

Lizenz

MIT

MCP Server for Agent8

Integrations