¿Qué es supernote-mcp?
supernote-mcp, del usuario de GitHub ridget, conecta un cliente MCP a una tableta de tinta electrónica Ratta Supernote en la misma red Wi-Fi. Captura la pantalla en directo mientras escribes, lista archivos, devuelve la escritura reconocida de un cuaderno como texto o sus páginas como imágenes y copia archivos hacia y desde la tableta. Usa dos funciones que la tableta ya tiene: Screen Mirroring en el puerto 8080 y el servidor de archivos Browse & Access en el puerto 8089.
Está escrito en TypeScript con licencia MIT, se publica en npm y como binarios independientes para cinco plataformas, y tiene unas 2 estrellas en GitHub. La versión 0.2.3, publicada el 22 de septiembre de 2026, añadió la herramienta de descarga. No tiene relación con Ratta.
Cómo instalar supernote-mcp
npx -y supernote-mcp¿Merece la pena supernote-mcp?
supernote-mcp hace seis cosas y las hace sin adornos. supernote_snapshot devuelve la pantalla actual como PNG, las herramientas de listar, leer y renderizar recorren los cuadernos guardados, y las de subir y descargar mueven archivos. Leer una nota devuelve como texto el reconocimiento de escritura de la propia tableta, lo que le cuesta a un modelo mucho menos que las imágenes; el renderizado se limita a 20 páginas por llamada. Cada herramienta agota su tiempo a los 10 segundos con un mensaje que señala la causa probable, y ninguna toca la tableta hasta que se la llama.
Las dos interfaces en las que se apoya se obtuvieron por ingeniería inversa, y el README lo dice: el espejo de pantalla y Browse & Access no están documentados para programas, y una actualización de firmware podría cambiarlos o romperlos. La página de soporte de Ratta describe Browse & Access como un servidor de archivos que se abre en un navegador en la misma Wi-Fi, y ni ella ni el README mencionan una contraseña o un PIN. Nada en ninguno de los dos indica que la tableta limite quién se conecta, así que, mientras un interruptor esté activado, trata su pantalla o sus archivos como abiertos a cualquiera en esa red.
La pega: el agente obtiene acceso a archivos en las dos direcciones. supernote_upload_file envía cualquier archivo local que el proceso del servidor pueda leer, y supernote_download_file escribe en una ruta local, $TMPDIR por defecto. Si falla la dirección configurada, el servidor recorre toda tu subred en el puerto 8080 para encontrar la tableta; en una red de oficina, ese rastreo puede hacer saltar una alarma, y SUPERNOTE_DISCOVER=0 lo desactiva. Una VPN o un proxy en el ordenador rompen la conexión.
Nuestra opinión: para quien tiene un Supernote, planifica en papel y quiere el boceto en el chat sin exportarlo, es el camino más corto, y la configuración se reduce a dos interruptores y una dirección IP. Activa las funciones de la tableta solo durante la sesión y cuenta con interrupciones tras las grandes actualizaciones de firmware mientras su único desarrollador se pone al día.
Dónde se gana su sitio
Una responsable de producto que dibuja flujos en un Supernote Manta durante las reuniones
Convertir el boceto de esta tarde en una especificación escrita
Activa Screen Mirroring, pide al agente una captura de la pantalla y deja que redacte la especificación a partir de la imagen. Gratis; cada captura es una imagen en el contexto del modelo.
Un estudiante de posgrado con un semestre de apuntes en un Nomad
Resumir mis apuntes sobre un tema antes de un examen
Abre Browse & Access, pide al agente que liste /Note y luego que lea como texto los cuadernos pertinentes con supernote_read_note. Las notas sin texto reconocido pasan a páginas renderizadas, hasta 20 por llamada.
Una abogada que anota PDF en la tableta
Enviar un borrador a mi Supernote y recuperar la copia anotada
Sube el PDF con supernote_upload_file, anótalo en el dispositivo y descárgalo con supernote_download_file. Deja Browse & Access apagado en la Wi-Fi compartida de la oficina cuando no lo uses.
Antes de decidirte
- Puesta en marcha
- Activa Screen Mirroring o Browse & Access en la tableta y anota su dirección IP; después ejecuta claude mcp add con SUPERNOTE_IP y npx -y supernote-mcp. Necesita Node.js 18+, Bun o el binario independiente; una reserva DHCP mantiene fija la IP.
- Integraciones
- Dispositivos Supernote con Screen Mirroring (de la clase Manta, Nomad, A5X y A6X). Se basa en la biblioteca supernote-typescript para capturar fotogramas y leer archivos .note. Cualquier cliente MCP por stdio.
- Datos y privacidad
- Funciona en local por stdio. Las imágenes de pantalla, el texto de las notas y el contenido de los archivos llegan a tu proveedor de modelos. El espejo de la tableta (puerto 8080) y su servidor de archivos (puerto 8089) son accesibles en la red local mientras están activados. Las subidas leen cualquier archivo local al que tenga acceso el servidor.
- Coste a escala
- Gratuito con licencia MIT. La tableta es el único coste.
- Límites
- Misma red Wi-Fi y sin VPN ni proxy. Las interfaces sin documentar pueden romperse con las actualizaciones de firmware. El renderizado se limita a 20 páginas y las llamadas agotan su tiempo a los 10 segundos.
Lo bueno
- Lee la escritura reconocida como texto, no solo como imágenes
- Tiempo de espera de 10 segundos con mensajes de error claros
- Instalación con npm, Bun o binario independiente
- Solo toca la tableta cuando se llama a una herramienta
Lo malo
- Depende de interfaces sin documentar obtenidas por ingeniería inversa
- El espejo y el servidor de archivos de la tableta no piden contraseña
- La detección de respaldo rastrea toda la subred
- Un único desarrollador y unas 2 estrellas
Ideal para
Propietarios de un Supernote Manta, Nomad, A5X o A6X que escriben a mano al planificar o en reuniones y quieren que un agente lea esas páginas.
supernote-mcp: preguntas frecuentes
- ¿Merece la pena supernote-mcp?
- Un puente ordenado y acotado que hace útil la escritura a mano de un Supernote en una conversación con un agente, apoyado en interfaces sin documentar que la próxima actualización de firmware podría cambiar. Le damos un 3.6 sobre 5.
- ¿Cuánto cuesta supernote-mcp?
- Gratuito y de código abierto (MIT). Necesita un Supernote con Screen Mirroring o Browse & Access.
- ¿Qué inconvenientes tiene supernote-mcp?
- Depende de interfaces sin documentar obtenidas por ingeniería inversa; el espejo y el servidor de archivos de la tableta no piden contraseña; la detección de respaldo rastrea toda la subred; un único desarrollador y unas 2 estrellas.
- ¿Para quién es supernote-mcp?
- Propietarios de un Supernote Manta, Nomad, A5X o A6X que escriben a mano al planificar o en reuniones y quieren que un agente lea esas páginas.
- ¿Cuánto cuesta supernote-mcp para un equipo o en producción?
- Gratuito con licencia MIT. La tableta es el único coste.
- ¿Es supernote-mcp seguro para los datos de la empresa?
- Funciona en local por stdio. Las imágenes de pantalla, el texto de las notas y el contenido de los archivos llegan a tu proveedor de modelos. El espejo de la tableta (puerto 8080) y su servidor de archivos (puerto 8089) son accesibles en la red local mientras están activados. Las subidas leen cualquier archivo local al que tenga acceso el servidor.
Respuestas comprobadas el 14 nov 2026.