gamemaker-link-proxy/README.md

MCP Proxy client for GameMaker-Link - Connect Claude Desktop to GameMaker Studio

# GameMaker-Link MCP

🎮 **Conecta Claude Desktop con GameMaker Studio** - Genera código GameMaker directamente desde Claude Desktop usando comandos naturales.

## ¿Qué es GameMaker-Link?

GameMaker-Link es un servidor MCP (Model Context Protocol) que permite usar Claude Desktop para generar y modificar código de GameMaker Studio de forma inteligente. Simplemente describe lo que quieres crear y Claude generará el código GameMaker apropiado.

### ✨ Características Principales

- 🤖 **Integración nativa con Claude Desktop** - Usa lenguaje natural para crear assets
- 🔒 **Código protegido en servidor remoto** - Tu lógica de negocio permanece segura
- ⚡ **Respuestas instantáneas** - API optimizada para velocidad
- 🎨 **Soporte completo GameMaker** - Sprites, objetos, scripts, shaders y más
- 🔄 **Sincronización automática** - Los archivos se actualizan automáticamente

## 🚀 Instalación Rápida

### Paso 1: Obtén tu API Key
1. Visita [gamemaker-link.com](https://gamemaker-link.com)
2. Crea una cuenta gratuita (3 días de prueba)
3. Copia tu API Key del dashboard

### Paso 2: Configura Claude Desktop
1. **Windows:** Abre `%APPDATA%\Claude\claude_desktop_config.json`
2. **Mac:** Abre `~/Library/Application Support/Claude/claude_desktop_config.json`
3. Agrega la configuración:

```json
{
  "mcpServers": {
    "gamemaker-link": {
      "command": "npx",
      "args": ["@gamemaker-link/proxy", "--token=TU_API_KEY_AQUI"],
      "env": {
        "GAMEMAKER_SERVER_URL": "https://gamemaker-link.com/mcp"
      }
    }
  }
}
```

### Paso 3: Reinicia Claude Desktop
Cierra y vuelve a abrir Claude Desktop. Verás "GameMaker-Link" en la barra inferior si todo está correcto.

## 💡 Ejemplos de Uso

### Crear un Sprite
```
Crea un sprite llamado "player_idle" en mi proyecto ubicado en "C:/MiJuego/"
```

### Crear un Objeto con Movimiento
```
Crea un objeto "obj_player" en "C:/MiJuego/" que se mueva con las teclas de dirección
```

### Leer Código Existente
```
Muéstrame el código del sprite "enemy_walk" en mi proyecto "C:/MiJuego/"
```

## 🛠️ Herramientas Disponibles (MVP)

| Herramienta | Descripción | Parámetros |
|-------------|-------------|------------|
| `create_sprite` | Crea un nuevo sprite | `projectPath`, `spriteName` |
| `read_sprite` | Lee configuración de sprite existente | `projectPath`, `spriteName` |
| `create_object` | Crea un nuevo objeto GameMaker | `projectPath`, `objectName` |

### 🔜 Próximamente (25 herramientas total)
- Modificación de código de objetos
- Creación y edición de scripts
- Manejo de shaders
- Gestión de rooms y layers
- Sistema de backups automático
- Y mucho más...

## 📋 Requisitos del Sistema

- **GameMaker Studio 2022+** (cualquier versión)
- **Claude Desktop** instalado
- **Node.js 16+** (se instala automáticamente con npx)
- **Windows 10+** o **macOS 10.15+**

## 🔧 Troubleshooting

### "GameMaker-Link no aparece en Claude Desktop"
1. Verifica que el archivo `claude_desktop_config.json` esté en la ruta correcta
2. Confirma que tu API Key sea válida
3. Reinicia Claude Desktop completamente

### "Error de conexión al servidor"
1. Verifica tu conexión a internet
2. Confirma que tu API Key no haya expirado
3. Contacta soporte si persiste el problema

### "No encuentra mi proyecto GameMaker"
1. Usa rutas absolutas (ejemplo: `C:/MisJuegos/Proyecto/`)
2. Asegúrate de que el archivo `.yyp` esté en la ruta indicada
3. Verifica permisos de lectura/escritura en la carpeta

## 💰 Planes y Precios


| Plan | Precio | Requests/hora | Requests/día | Duración Trial |
|------|--------|---------------|--------------|----------------|
| **Free Trial** | €0 | 1 | 10 | 3 días |
| **Basic** | €19.95/mes | 5 | 25 | - |
| **Pro** | €35.95/mes | 15 | 65 | - |
| **Enterprise** | €299.95/mes | 35 | 250 | - |

## 🆘 Soporte

- **Documentación:** [docs.gamemaker-link.com](https://gamemaker-link.com)
- **Email:** support@gamemaker-link.com
- **Discord:** [Únete a nuestra comunidad](https://discord.gg/gamemaker-link)

## 🔒 Privacidad y Seguridad

- Tu código GameMaker **nunca** se almacena en nuestros servidores
- Todas las conexiones usan **HTTPS/TLS encryption**
- **Zero-knowledge** - Solo procesamos requests, no almacenamos contenido
- Cumplimiento **GDPR** completo

## 📝 Licencia

Licencia comercial - Ver [gamemaker-link.com/license](https://gamemaker-link.com/license)

---

**🚀 ¿Listo para revolucionar tu flujo de trabajo en GameMaker?**  
[Empieza tu prueba gratuita ahora](https://gamemaker-link.com/signup)