Qu’est-ce que flipper-mcp ?
flipper-mcp, de l'utilisateur GitHub Str1ck9, relie un client MCP comme Claude Code à un Flipper Zero branché en USB. Chaque outil envoie une commande à la ligne de commande série du Flipper lui-même : écouter une fréquence Sub-GHz, capturer des impulsions brutes, lire des badges NFC, RFID 125 kHz et iButton, envoyer des codes infrarouges, lire et écrire des fichiers sur la carte SD, basculer des broches GPIO et appuyer sur les boutons de l'appareil pour parcourir ses menus.
C'est du Python sous licence MIT, qui demande Python 3.11 ou plus récent et s'installe depuis un clone git ; il n'existe pas de paquet PyPI. Le projet compte environ 6 étoiles sur GitHub. Les sept commits, jusqu'à la v0.5.0, sont tous arrivés le 19 avril 2026, et le dépôt n'a pas bougé depuis.
Installer flipper-mcp
git clone https://github.com/Str1ck9/flipper-mcp && cd flipper-mcp && uv venv && uv pip install -e .flipper-mcp vaut-il le coup ?
flipper-mcp transforme un Flipper Zero en 54 outils MCP, et la plupart font ce qu'ils annoncent, car chacun est un appel court à une vraie commande de la CLI du Flipper. Le README fait état de tests sur du matériel réel avec le firmware officiel 1.4.x et s'attend à ce que les versions communautaires Momentum, RogueMaster et Xtreme fonctionnent aussi. Ce qui le place au-dessus d'un simple enrobage de commandes, c'est un registre de protocoles : 13 entrées fournies, des télécommandes de garage Princeton à Security+ 2.0 et aux badges EM4100, chacune avec ses fréquences typiques, ses motifs de reconnaissance et une note de sécurité claire. scan_and_identify peut ainsi capturer un signal et nommer ce qui l'a émis.
Le volet physique doit être dit clairement. Ce serveur commande un émetteur radio. subghz_tx_from_file rejoue une capture .sub enregistrée, ir_tx et ir_universal_send envoient des codes infrarouges, gpio_write pilote les broches du connecteur et flipper_cli exécute n'importe quelle commande acceptée par le firmware. D'après notre lecture de server.py, aucun de ces outils ne demande de confirmation ; l'invite d'approbation du client MCP est le seul garde-fou. Rejouer une télécommande de portail, cloner un badge ou lire la carte de quelqu'un n'est acceptable que sur des appareils qui vous appartiennent ou que vous êtes autorisé à tester, et l'émission Sub-GHz reste limitée par les règles de bandes régionales que le firmware applique.
Le hic : c'est un projet d'une seule journée. Sept commits le 19 avril 2026 l'ont mené de la première version à la v0.5.0, rien n'est arrivé dans les mois qui ont suivi, et il n'y a pas de version PyPI. Le registre distant télécharge des fichiers de protocole depuis n'importe quelle URL d'index que vous lui donnez, et la vérification SHA-256 n'a lieu que si l'index fournit un hash. La CLI du firmware d'origine écoute en outre avec un filtre de 650 kHz, là où l'app Read de l'appareil utilise 270 kHz, si bien que des signaux faibles que l'app capterait peuvent revenir vides.
Notre avis : comme carnet de laboratoire qui permet à un agent d'étiqueter ce qu'entend un Flipper, il est bien fait, et il tourne entièrement sur votre machine via stdio, sans port réseau. Traitez chaque outil d'émission comme une gâchette réelle, réglez le client pour qu'il demande avant chaque appel et prévoyez d'entretenir votre propre fork si une mise à jour du firmware casse les plugins de la CLI.
Là où il fait la différence
Un pentesteur qui prépare une mission de sécurité physique avec un périmètre signé
Recenser les badges et télécommandes du périmètre qui utilisent des codes fixes
Lisez chaque badge du périmètre avec rfid_read ou nfc_detect et identifiez les télécommandes avec scan_and_identify ; les notes de sécurité du registre signalent les protocoles à code fixe comme Princeton. Gratuit en dehors du Flipper ; gardez chaque capture dans le périmètre écrit.
Un amateur de domotique avec un tiroir plein de télécommandes 433 MHz
Déterminer quel protocole utilise chacune de mes télécommandes avant de la relier à un hub
Lancez scan_and_identify sur 433.92 MHz en appuyant sur chaque bouton, puis flipper_file_inspect sur les fichiers enregistrés. Les télécommandes à code tournant que les décodeurs d'origine ne reconnaissent pas demandent subghz_rx_raw ou un firmware communautaire.
Un enseignant en électronique avec un Flipper sur la paillasse
Montrer aux élèves comment une télécommande infrarouge code ses commandes
Capturez la télécommande du téléviseur de la classe avec ir_rx, puis rejouez le code NEC décodé sur ce même téléviseur avec ir_tx. Cela prend quelques minutes et reste sur du matériel qui appartient à l'école.
Avant de vous engager
- Mise en route
- Clonez le dépôt, créez un environnement virtuel avec uv et installez-le en mode éditable, puis lancez flipper-smoke pour vérifier que le Flipper est détecté. Enregistrez le binaire flipper-mcp avec claude mcp add ou dans la configuration de Claude Desktop. Nécessite Python 3.11+ et un câble USB-C de données.
- Intégrations
- Firmware officiel 1.4.x du Flipper Zero, avec Momentum, RogueMaster et Xtreme censés fonctionner ; une radio CC1101 externe sur le connecteur GPIO via device=1 ou FLIPPER_DEFAULT_DEVICE. Une CLI flipper-registry gère les fichiers de protocole.
- Données et confidentialité
- Fonctionne en local via stdio et n'ouvre aucun port réseau. Les captures, les fichiers de la carte SD et les informations sur l'appareil passent par le client jusqu'à votre fournisseur de modèles. Les téléchargements du registre vont vers l'URL d'index que vous indiquez ; les protocoles installés sont mis en cache dans ~/.local/share/flipper-mcp.
- Coût à grande échelle
- Gratuit sous MIT. Le seul coût est le Flipper Zero lui-même.
- Limites
- Un seul programme peut occuper le port série : qFlipper et l'onglet Flipper Lab du navigateur doivent donc être fermés. Après une mise à jour du firmware, des plugins CLI périmés cassent les commandes ir, nfc et rfid. La CLI utilise un filtre Sub-GHz de 650 kHz et ne peut pas changer de préréglage.
Les points forts
- 54 outils s'appuyant sur la CLI du Flipper
- Le registre de protocoles identifie 13 types de signaux courants
- Fonctionne en local via stdio, sans port réseau
- Des macros ouvrent les apps Sub-GHz, NFC et infrarouge en un seul appel
Les points faibles
- Les outils d'émission, GPIO et CLI brute n'ont aucune étape de confirmation
- Tous les commits sont arrivés le même jour d'avril 2026
- La vérification du hash du registre distant est facultative
- Installation par clone git uniquement ; pas de paquet PyPI
Idéal pour
Chercheurs en sécurité et amateurs de matériel qui possèdent un Flipper Zero et veulent qu'un agent capture, étiquette et catalogue les signaux de leurs propres appareils.
Alternatives à flipper-mcp
flipper-mcp : questions fréquentes
- flipper-mcp vaut-il le coup ?
- Une passerelle compétente et honnête vers un Flipper Zero, qui confie à un agent le bouton d'émission sans seconde vérification. Sa place est donc uniquement sur un banc où chaque appareil à portée vous appartient. Nous lui donnons 3.5 sur 5.
- Combien coûte flipper-mcp ?
- Gratuit et open source (MIT). Nécessite un Flipper Zero.
- Quels sont les inconvénients de flipper-mcp ?
- Les outils d'émission, GPIO et CLI brute n'ont aucune étape de confirmation; tous les commits sont arrivés le même jour d'avril 2026; la vérification du hash du registre distant est facultative; installation par clone git uniquement ; pas de paquet PyPI.
- À qui s’adresse flipper-mcp ?
- Chercheurs en sécurité et amateurs de matériel qui possèdent un Flipper Zero et veulent qu'un agent capture, étiquette et catalogue les signaux de leurs propres appareils.
- Combien coûte flipper-mcp pour une équipe ou en production ?
- Gratuit sous MIT. Le seul coût est le Flipper Zero lui-même.
- flipper-mcp est-il sûr pour les données de l’entreprise ?
- Fonctionne en local via stdio et n'ouvre aucun port réseau. Les captures, les fichiers de la carte SD et les informations sur l'appareil passent par le client jusqu'à votre fournisseur de modèles. Les téléchargements du registre vont vers l'URL d'index que vous indiquez ; les protocoles installés sont mis en cache dans ~/.local/share/flipper-mcp.
- Quelles sont les meilleures alternatives à flipper-mcp ?
- Les alternatives les plus proches que nous avons testées sont AetherLink SDR MCP.
Réponses vérifiées le 14 nov. 2026.