boosterarena-mcp 0.1.0

package/LEEME.md

@@ -0,0 +1,109 @@
+# El MCP de Booster
+
+Tu agente de código trabajando **dentro** de [boosterarena.com](https://boosterarena.com): abre
+tus proyectos, arma los slides, pone boosters y Boost Arenas, sube tus imágenes y tus audios, y
+lo guarda en tu cuenta. Lo que salga queda en tu galería como si lo hubieras hecho a mano.
+
+Es **gratis** y va con la cuenta gratuita. Lo único que pide plan Pro son ciertos *elementos*
+premium, y cuando eso pasa el servidor te lo dice con todas las letras para que tu agente pueda
+explicártelo, en vez de fallar sin motivo.
+
+---
+
+## Ponerlo a andar
+
+Hace falta **Node 20 o más nuevo**.
+
+**1. Entra con tu cuenta** (una sola vez, en tu terminal):
+
+```
+npx boosterarena-mcp entrar
+```
+
+Se abre el navegador, entras con Google y listo. Si prefieres un enlace por correo:
+`npx boosterarena-mcp entrar --correo tu@correo.com`.
+
+La credencial se guarda en `~/.booster/credenciales.json`, solo en tu equipo. Para comprobar a
+nombre de quién estás: `npx boosterarena-mcp quien`. Para borrarla: `npx boosterarena-mcp salir`.
+
+**2. Conecta tu agente.** En Claude Code:
+
+```
+claude mcp add booster -- npx -y boosterarena-mcp servidor
+```
+
+O a mano, en el `mcp.json` de tu cliente:
+
+```json
+{
+  "mcpServers": {
+    "booster": { "command": "npx", "args": ["-y", "boosterarena-mcp", "servidor"] }
+  }
+}
+```
+
+Eso es todo. No hay servidor que hospedar ni llave de API que pedir: esto corre en tu máquina y
+habla con Booster con **tu** sesión.
+
+---
+
+## Qué puede hacer
+
+**Proyectos** — `listar_proyectos`, `abrir_proyecto`, `crear_proyecto`, `guardar_proyecto`,
+`ver_slide`. Nada se sube hasta que se llama a `guardar_proyecto`: el agente trabaja sobre un
+borrador y tú decides cuándo se publica.
+
+**Contenido** — poner texto, imágenes, figuras y dibujos de la biblioteca (más de 3.000
+ilustraciones y 280 fondos, que se buscan por nombre en español o inglés).
+
+**Boosters y Boost Arenas** — colocarlos y configurarlos por nombre. `describir` te dice qué
+acepta cada uno antes de intentarlo, así que el agente no tiene que adivinar los campos.
+
+**Archivos tuyos** — `subir_imagen` y `subir_audio` meten un archivo de tu disco en tu
+almacenamiento y te devuelven la URL, lista para usar en un slide. Es la puerta para una fábrica
+que genera fuera (imágenes con tu propia gráfica, voz con el TTS que quieras): Booster no genera
+ninguna de las dos cosas, pero se las traga sin distinguirlas de las que subiste a mano.
+
+> El nombre del archivo en la nube es el **hash de su contenido**: subir dos veces lo mismo
+> devuelve la misma URL y ocupa una sola vez. Para quien repite la misma ilustración en cientos
+> de clases, eso no es un detalle.
+
+**Encargos** — quitar el fondo de una imagen, el Sombrero Mágico y el Transformador se resuelven
+sin abrir el navegador.
+
+La lista exacta la da el propio servidor con `tools/list`, y crece con el catálogo.
+
+---
+
+## Si algo no arranca
+
+- **«La sesión ya no vale»** — corre `npx boosterarena-mcp entrar` otra vez.
+- **El comando se queda mudo** — sin argumentos y sin terminal, arranca el servidor MCP y espera
+  por la entrada estándar. Es lo correcto: lo arranca tu cliente, no tú. Para ver la ayuda,
+  escríbelo en una terminal a secas.
+- **El cliente se desconecta sin decir nada** — mira el registro del servidor; todo lo que cuenta
+  va por la salida de error, porque la salida estándar es del protocolo.
+
+---
+
+## Para quien trabaje en el código
+
+Desde el repo, el servidor compila el núcleo al vuelo y usa siempre el código vivo:
+
+```
+node mcp/cli.mjs entrar
+node mcp/cli.mjs servidor
+```
+
+`npm run mcp:construir` deja `mcp/dist/nucleo.mjs`, que es lo que se publica. Ese script aborta
+si el núcleo arrastra React o CSS, y si algún `.mjs` usa un módulo que el `package.json` del
+paquete no declara — los dos fallos se ven igual desde dentro del repo (todo funciona) y rompen
+el paquete en casa ajena.
+
+Para probar el paquete de verdad hay que **instalarlo fuera del repo**, no correrlo desde aquí:
+
+```
+cd mcp && npm pack
+cd /una/carpeta/limpia && npm i /ruta/al/boosterarena-mcp-X.Y.Z.tgz
+./node_modules/.bin/boosterarena-mcp quien
+```

package/cli.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+// ─────────────────────────────────────────────────────────────────────────────
+//  UN SOLO COMANDO PARA TODO: `boosterarena-mcp`.
+//
+//  Antes eran dos rutas de archivo que había que escribir a mano (`node mcp/sesion.mjs entrar`,
+//  `node mcp/servidor.mjs`) y solo funcionaban desde la carpeta del proyecto. Fuera del repo eso
+//  no vale: quien lo instale no tiene ni carpeta ni rutas. Así que hay un comando y despacha:
+//
+//      boosterarena-mcp entrar     ← el maestro, una vez, en su terminal
+//      boosterarena-mcp quien
+//      boosterarena-mcp salir
+//      boosterarena-mcp servidor   ← esto lo arranca el CLIENTE, no una persona
+//
+//  ⚠️ SIN ARGUMENTOS HACE DOS COSAS DISTINTAS, Y ES A PROPÓSITO. Un cliente MCP arranca el
+//  comando a secas y habla por la entrada estándar; una persona lo escribe a secas y espera que
+//  le explique algo. Se distinguen por si la entrada es una terminal (`isTTY`): si lo es, ayuda;
+//  si no, servidor. Sin esto, o el cliente se queda sin servidor o la persona se queda mirando
+//  un comando mudo que parece colgado — que es como se pierde la primera media hora.
+// ─────────────────────────────────────────────────────────────────────────────
+const [, , orden] = process.argv;
+const resto = process.argv.slice(3);
+const correo = resto.includes('--correo') ? resto[resto.indexOf('--correo') + 1] : null;
+
+function ayuda() {
+  console.log(`
+  El MCP de Booster — tu agente trabajando dentro de boosterarena.com
+
+    boosterarena-mcp entrar                      entrar con Google (recomendado)
+    boosterarena-mcp entrar --correo tu@correo   entrar con un enlace por correo
+    boosterarena-mcp quien                       a nombre de quién estoy
+    boosterarena-mcp salir                       borrar la credencial de este equipo
+
+  Después de "entrar", el servidor lo arranca tu agente. En Claude Code:
+
+    claude mcp add booster -- npx -y boosterarena-mcp servidor
+
+  O a mano, en el mcp.json de tu cliente:
+
+    { "mcpServers": { "booster": {
+        "command": "npx", "args": ["-y", "boosterarena-mcp", "servidor"] } } }
+`);
+}
+
+try {
+  if (orden === 'servidor') {
+    await import('./servidor.mjs');
+  } else if (orden === 'entrar' || orden === 'quien' || orden === 'salir') {
+    const puerta = await import('./sesion.mjs');
+    if (orden === 'entrar') await puerta.entrar(correo);
+    else if (orden === 'quien') await puerta.quien();
+    else puerta.salir();
+  } else if (!orden && !process.stdin.isTTY) {
+    await import('./servidor.mjs');   // lo arrancó un cliente MCP
+  } else {
+    ayuda();
+    // Un argumento que no existe es un error, no una consulta: quien escribió `entar` merece un
+    // código de salida que su script pueda notar.
+    if (orden) { console.error(`  ✕ No conozco la orden "${orden}".\n`); process.exit(1); }
+  }
+} catch (e) {
+  console.error(`\n  ✕ ${e.message}\n`);
+  process.exit(1);
+}