# 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

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

Edita `.env` y coloca tu clave:

```bash
ANTHROPIC_API_KEY=your-anthropic-api-key
```

## Ejecutar

```bash
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:

```json
{
  "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:

```json
{
  "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:

```bash
ANTHROPIC_MODEL=claude-sonnet-4-6
```