Configuración de Gemini CLI

Cómo usar WEPPY MCP Server de WEPPY Roblox AI Toolkit desde Google Gemini CLI.

Requisitos previos

1. Node.js (v18.0.0 o superior)

   node --version

2. Gemini CLI instalado

   npm install -g @google/gemini-cli

3. WEPPY Roblox Studio Plugin instalado

Registrar el servidor MCP

Método 1: Comando CLI (recomendado)

Puedes registrarlo con una sola línea en el terminal:

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

El flag --trust omite el prompt de confirmación en cada llamada a una herramienta.

Para registrar como configuración global, añade -s user:

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

Método 2: Editar el archivo de configuración

Añade el siguiente contenido al archivo .gemini/settings.json:

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

Ubicación del archivo de configuración:

Método 3: Usar variables de entorno

Si se necesitan variables de entorno específicas:

CLI:

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

Archivo de configuración:

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

Probar la conexión

1. Ejecuta Roblox Studio → pestaña Plugins → WEPPY → Connect
2. Ejecuta Gemini CLI y escribe lo siguiente:

   Dime qué está seleccionado actualmente en Roblox Studio

Verificar el estado del servidor MCP

Dentro de Gemini CLI puedes verificar el estado de los servidores conectados con el comando /mcp:

/mcp

Solución de problemas

El servidor no arranca

Ejecuta el servidor MCP directamente para ver el error:

npx -y @weppy/roblox-mcp@latest

Fallo de conexión

• Verifica que WEPPY Roblox Studio Plugin esté en estado Connected
• Verifica que el puerto 3002 no esté bloqueado por el firewall
• Verifica el estado del servidor con el comando /mcp

Conflicto de herramientas

Si varios servidores MCP tienen herramientas con el mismo nombre, se añade el prefijo serverAlias__toolName.