Pengaturan Gemini CLI

Cara menggunakan Roblox MCP di Google Gemini CLI.

Prasyarat

1. Node.js (v18.0.0 ke atas)

   node --version

2. Gemini CLI terinstal

   npm install -g @google/gemini-cli

3. Plugin Roblox Studio instalasi selesai

Registrasi Server MCP

Metode 1: Perintah CLI (Direkomendasikan)

Anda dapat mendaftarkan dengan satu baris di terminal:

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

Flag --trust melewati prompt konfirmasi setiap kali alat dipanggil.

Tambahkan -s user untuk mendaftarkan sebagai konfigurasi global:

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

Metode 2: Edit File Konfigurasi

Tambahkan konten berikut ke file .gemini/settings.json:

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

Lokasi file konfigurasi:

Metode 3: Menggunakan Variabel Lingkungan

Ketika variabel lingkungan tertentu diperlukan:

CLI:

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

File konfigurasi:

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

Uji Koneksi

1. Jalankan Roblox Studio → tab Plugins → WEPPY → Connect
2. Jalankan Gemini CLI lalu masukkan:

   Beritahu saya apa yang dipilih saat ini di Roblox Studio

Memeriksa Status Server MCP

Anda dapat memeriksa status server yang terhubung dengan perintah /mcp di dalam Gemini CLI:

/mcp

Pemecahan Masalah

Saat Server Tidak Mau Mulai

Jalankan server MCP langsung untuk memeriksa error:

npx -y @weppy/roblox-mcp

Koneksi Gagal

• Verifikasi apakah plugin Roblox Studio dalam status Connected
• Verifikasi apakah port 3002 tidak diblokir oleh firewall
• Periksa status server dengan perintah /mcp

Konflik Alat

Jika ada alat dengan nama yang sama dari beberapa server MCP, awalan dalam format serverAlias__toolName akan ditambahkan.