Gemini CLI Setup

Wie Sie Roblox MCP mit der Google Gemini CLI verwenden.

Voraussetzungen

1. Node.js (v18.0.0 oder höher)

   node --version

2. Gemini CLI installiert

   npm install -g @google/gemini-cli

3. Roblox Studio Plugin-Installation abgeschlossen

MCP-Server registrieren

Methode 1: CLI-Befehl (Empfohlen)

Registrieren Sie es in einer Zeile vom Terminal aus:

gemini mcp add weppy-roblox-mcp npx --trust -- -y @weppy/roblox-mcp

Das Flag --trust überspringt die Bestätigungsabfrage bei jedem Tool-Aufruf.

Um es als globale Einstellung zu registrieren, fügen Sie -s user hinzu:

gemini mcp add weppy-roblox-mcp npx -s user --trust -- -y @weppy/roblox-mcp

Methode 2: Konfigurationsdatei bearbeiten

Fügen Sie Folgendes zu Ihrer .gemini/settings.json-Datei hinzu:

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp"]
    }
  }
}

Speicherort der Konfigurationsdatei:

Methode 3: Mit Umgebungsvariablen

Wenn bestimmte Umgebungsvariablen benötigt werden:

CLI:

gemini mcp add weppy-roblox-mcp npx --trust -e HTTP_PORT=3002 -- -y @weppy/roblox-mcp

Konfigurationsdatei:

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp"],
      "env": {
        "HTTP_PORT": "3002"
      }
    }
  }
}

Verbindungstest

1. Starten Sie Roblox Studio → Plugins-Tab → WEPPY → Connect
2. Führen Sie die Gemini CLI aus und geben Sie ein:

   Sage mir, was derzeit in Roblox Studio ausgewählt ist

MCP-Server-Status prüfen

Verwenden Sie den /mcp-Befehl innerhalb der Gemini CLI, um den Status der verbundenen Server zu prüfen:

/mcp

Fehlerbehebung

Server startet nicht

Führen Sie den MCP-Server direkt aus, um den Fehler zu sehen:

npx -y @weppy/roblox-mcp

Verbindung schlägt fehl

• Bestätigen Sie, dass das Roblox Studio Plugin den Status Connected anzeigt
• Prüfen Sie, dass Port 3002 nicht von einer Firewall blockiert wird
• Prüfen Sie den Server-Status mit dem /mcp-Befehl

Tool-Namenskonflikte

Wenn mehrere MCP-Server Tools mit demselben Namen haben, werden die Tool-Namen im Format serverAlias__toolName mit einem Präfix versehen.