Qu’est-ce que supernote-mcp ?
supernote-mcp, de l'utilisateur GitHub ridget, relie un client MCP à une tablette à encre électronique Ratta Supernote sur le même réseau Wi-Fi. Il capture l'écran en direct pendant que vous écrivez, liste les fichiers, renvoie l'écriture reconnue d'un carnet sous forme de texte ou ses pages sous forme d'images, et copie des fichiers vers et depuis la tablette. Il s'appuie sur deux fonctions que la tablette possède déjà : Screen Mirroring sur le port 8080 et le serveur de fichiers Browse & Access sur le port 8089.
Il est écrit en TypeScript sous licence MIT, publié sur npm et en binaires autonomes pour cinq plateformes, et compte environ 2 étoiles sur GitHub. La version 0.2.3, sortie le 22 septembre 2026, a ajouté l'outil de téléchargement. Il n'a aucun lien avec Ratta.
Installer supernote-mcp
npx -y supernote-mcpsupernote-mcp vaut-il le coup ?
supernote-mcp fait six choses, et les fait simplement. supernote_snapshot renvoie l'écran actuel en PNG, les outils de liste, de lecture et de rendu parcourent les carnets enregistrés, et l'envoi et le téléchargement déplacent des fichiers. Lire une note renvoie sous forme de texte la reconnaissance d'écriture de la tablette elle-même, ce qui coûte bien moins cher à un modèle que des images ; le rendu est plafonné à 20 pages par appel. Chaque outil abandonne au bout de 10 secondes avec un message qui nomme la cause probable, et aucun ne touche la tablette avant d'être appelé.
Les deux interfaces sur lesquelles il repose ont été obtenues par rétro-ingénierie, et le README le dit : le miroir d'écran et Browse & Access ne sont pas documentés pour les programmes, et une mise à jour du firmware pourrait les modifier ou les casser. La page d'assistance de Ratta décrit Browse & Access comme un serveur de fichiers que l'on ouvre dans un navigateur sur le même Wi-Fi, et ni elle ni le README ne mentionnent de mot de passe ou de code PIN. Rien dans l'un ou l'autre n'indique que la tablette restreint qui se connecte, donc tant qu'une option est activée, considérez son écran ou ses fichiers comme ouverts à n'importe qui sur ce réseau.
Le hic : l'agent obtient un accès aux fichiers dans les deux sens. supernote_upload_file envoie n'importe quel fichier local que le processus serveur peut lire, et supernote_download_file écrit vers un chemin local, $TMPDIR par défaut. Si l'adresse configurée échoue, le serveur balaie tout votre sous-réseau sur le port 8080 pour trouver la tablette ; sur un réseau d'entreprise, ce balayage peut lui-même déclencher une alerte, et SUPERNOTE_DISCOVER=0 le désactive. Un VPN ou un proxy sur l'ordinateur coupe la connexion.
Notre avis : pour un propriétaire de Supernote qui planifie sur papier et veut son croquis dans la conversation sans l'exporter, c'est le chemin le plus court, et la configuration tient en deux options et une adresse IP. N'activez les fonctions de la tablette que pour la séance, et attendez-vous à des interruptions après les grosses mises à jour du firmware, le temps que son unique développeur s'adapte.
Là où il fait la différence
Une cheffe de produit qui esquisse des parcours sur un Supernote Manta en réunion
Transformer le croquis de cet après-midi en spécification écrite
Activez Screen Mirroring, demandez à l'agent une capture de l'écran et laissez-le rédiger la spécification à partir de l'image. Gratuit ; chaque capture est une image dans le contexte du modèle.
Un étudiant de master avec un semestre de notes de cours sur un Nomad
Résumer mes notes sur un sujet avant un examen
Ouvrez Browse & Access, faites lister /Note par l'agent, puis lire en texte les carnets concernés avec supernote_read_note. Les notes sans texte reconnu basculent sur des pages rendues, jusqu'à 20 par appel.
Une avocate qui annote des PDF sur la tablette
Envoyer un brouillon sur mon Supernote et récupérer la copie annotée
Envoyez le PDF avec supernote_upload_file, annotez-le sur l'appareil, puis récupérez-le avec supernote_download_file. Laissez Browse & Access désactivé sur le Wi-Fi partagé du bureau quand vous ne vous en servez pas.
Avant de vous engager
- Mise en route
- Activez Screen Mirroring ou Browse & Access sur la tablette et notez son adresse IP, puis lancez claude mcp add avec SUPERNOTE_IP renseigné et npx -y supernote-mcp. Nécessite Node.js 18+, Bun ou le binaire autonome ; une réservation DHCP garde l'IP stable.
- Intégrations
- Appareils Supernote dotés de Screen Mirroring (catégorie Manta, Nomad, A5X et A6X). S'appuie sur la bibliothèque supernote-typescript pour la capture d'image et la lecture des fichiers .note. Tout client MCP via stdio.
- Données et confidentialité
- Fonctionne en local via stdio. Images d'écran, texte des notes et contenu des fichiers partent chez votre fournisseur de modèles. Le miroir (port 8080) et le serveur de fichiers (port 8089) de la tablette sont accessibles sur le réseau local tant qu'ils sont activés. Les envois lisent n'importe quel fichier local accessible au serveur.
- Coût à grande échelle
- Gratuit sous licence MIT. La tablette est le seul coût.
- Limites
- Même réseau Wi-Fi, sans VPN ni proxy. Les interfaces non documentées peuvent casser avec les mises à jour du firmware. Le rendu est plafonné à 20 pages ; les appels abandonnent au bout de 10 secondes.
Les points forts
- Lit l'écriture reconnue en texte, pas seulement en images
- Délai de 10 secondes avec des messages d'erreur clairs
- Installation via npm, Bun ou binaire autonome
- Ne touche la tablette que lorsqu'un outil est appelé
Les points faibles
- Repose sur des interfaces non documentées issues de la rétro-ingénierie
- Le miroir et le serveur de fichiers de la tablette ne demandent aucun mot de passe
- La découverte de secours balaie tout le sous-réseau
- Un seul développeur et environ 2 étoiles
Idéal pour
Les propriétaires d'un Supernote Manta, Nomad, A5X ou A6X qui écrivent à la main pour planifier ou en réunion et veulent qu'un agent lise ces pages.
supernote-mcp : questions fréquentes
- supernote-mcp vaut-il le coup ?
- Une passerelle propre et étroite qui rend l'écriture manuscrite d'un Supernote utile dans une conversation avec un agent, posée sur des interfaces non documentées que la prochaine mise à jour du firmware pourrait changer. Nous lui donnons 3.6 sur 5.
- Combien coûte supernote-mcp ?
- Gratuit et open source (MIT). Nécessite un Supernote avec Screen Mirroring ou Browse & Access.
- Quels sont les inconvénients de supernote-mcp ?
- Repose sur des interfaces non documentées issues de la rétro-ingénierie; le miroir et le serveur de fichiers de la tablette ne demandent aucun mot de passe; la découverte de secours balaie tout le sous-réseau; un seul développeur et environ 2 étoiles.
- À qui s’adresse supernote-mcp ?
- Les propriétaires d'un Supernote Manta, Nomad, A5X ou A6X qui écrivent à la main pour planifier ou en réunion et veulent qu'un agent lise ces pages.
- Combien coûte supernote-mcp pour une équipe ou en production ?
- Gratuit sous licence MIT. La tablette est le seul coût.
- supernote-mcp est-il sûr pour les données de l’entreprise ?
- Fonctionne en local via stdio. Images d'écran, texte des notes et contenu des fichiers partent chez votre fournisseur de modèles. Le miroir (port 8080) et le serveur de fichiers (port 8089) de la tablette sont accessibles sur le réseau local tant qu'ils sont activés. Les envois lisent n'importe quel fichier local accessible au serveur.
Réponses vérifiées le 14 nov. 2026.