Roblox 3D Generator MCP

Servidor MCP para generar JSON de modelos 3D de Roblox Studio usando la API de Anthropic. El repo no incluye ninguna API key: cada usuario debe configurar su propia clave con ANTHROPIC_API_KEY.

Que hace

• Expone la herramienta MCP generate_roblox_3d.
• Recibe un prompt y una lista opcional selection con objetos seleccionados.
• Devuelve JSON valido para crear modelos nuevos o modificar objetos existentes.
• Usa reglas de posicion, apilado, cilindros, techos, soportes, efectos y jerarquia pensadas para Roblox Studio.

Instalacion

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

Edita .env y coloca tu clave:

ANTHROPIC_API_KEY=your-anthropic-api-key

Ejecutar

python server.py

El servidor MCP usa stdio. No imprime una URL porque lo debe lanzar un cliente MCP, como Claude Desktop, Codex u otro host compatible.

Configuracion MCP

Usa mcp_config.example.json como base y cambia las rutas absolutas:

{
  "mcpServers": {
    "roblox-3d-generator": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["/absolute/path/to/server.py"],
      "env": {
        "ANTHROPIC_API_KEY": "your-anthropic-api-key"
      }
    }
  }
}

Tambien puedes usar .env local para desarrollo. No subas .env a GitHub.

Herramientas MCP

generate_roblox_3d

Parametros:

• prompt: descripcion del objeto o cambio que quieres generar.
• selection: lista opcional de objetos seleccionados. Cuando hay seleccion y el prompt pide corregir o ajustar, el servidor devuelve modifications.

Ejemplo de entrada:

{
  "prompt": "Crea una torre medieval con antorchas y techo inclinado",
  "selection": []
}

server_info

Devuelve el nombre del servidor, el modelo configurado, si hay API key cargada y el limite de tokens configurado.

Seguridad

• Nunca escribas una API key directamente en server.py.
• Usa .env o variables de entorno del cliente MCP.
• .env esta ignorado por Git.
• Si alguna clave real estuvo en un archivo compartido, revocala y crea una nueva en la consola de Anthropic.

Modelo

Por defecto usa claude-sonnet-4-6. Puedes cambiarlo con:

ANTHROPIC_MODEL=claude-sonnet-4-6