O que é flipper-mcp?
O flipper-mcp, do usuário do GitHub Str1ck9, conecta um cliente MCP como o Claude Code a um Flipper Zero ligado por USB. Cada ferramenta envia um comando à linha de comando serial do próprio Flipper: escutar uma frequência Sub-GHz, capturar pulsos brutos, ler tags NFC, RFID de 125 kHz e iButton, enviar códigos infravermelhos, ler e gravar arquivos no cartão SD, alternar pinos GPIO e apertar os botões do aparelho para percorrer os menus.
É escrito em Python com licença MIT, exige Python 3.11 ou mais recente e é instalado a partir de um clone git; não há pacote no PyPI. Tem cerca de 6 estrelas no GitHub. Os sete commits, até a v0.5.0, chegaram em 19 de abril de 2026, e o repositório não mudou desde então.
Como instalar flipper-mcp
git clone https://github.com/Str1ck9/flipper-mcp && cd flipper-mcp && uv venv && uv pip install -e .flipper-mcp vale a pena?
O flipper-mcp transforma um Flipper Zero em 54 ferramentas MCP, e a maioria faz o que promete porque cada uma é uma chamada curta a um comando real da CLI do Flipper. O README relata validação em hardware real com o firmware oficial 1.4.x e espera que as versões da comunidade Momentum, RogueMaster e Xtreme também funcionem. O que o coloca acima de um simples wrapper de comandos é um registro de protocolos: 13 entradas incluídas, dos controles de garagem Princeton ao Security+ 2.0 e às tags EM4100, cada uma com frequências típicas, padrões de correspondência e uma nota de segurança clara, de modo que o scan_and_identify consegue capturar um sinal e dizer o que o emitiu.
O lado físico precisa ser dito com clareza. Este servidor controla um transmissor de rádio. O subghz_tx_from_file reproduz uma captura .sub salva, ir_tx e ir_universal_send disparam códigos infravermelhos, gpio_write aciona pinos do conector e flipper_cli executa qualquer comando que o firmware aceite. Pela nossa leitura do server.py, nenhuma dessas ferramentas pede confirmação; o aviso de aprovação do próprio cliente MCP é a única barreira. Reproduzir o controle de um portão, clonar um crachá ou ler o cartão de outra pessoa só é aceitável em aparelhos que são seus ou que você tem autorização para testar, e a transmissão Sub-GHz fica limitada pelas regras regionais de faixa que o firmware aplica.
O porém: é um projeto de um dia só. Sete commits em 19 de abril de 2026 o levaram da primeira versão à v0.5.0, nada chegou nos meses seguintes e não há versão no PyPI. O registro remoto baixa arquivos de protocolo de qualquer URL de índice que você informar, e a verificação SHA-256 só roda quando o índice fornece um hash. Além disso, a CLI do firmware original escuta com um filtro de 650 kHz, enquanto o app Read do aparelho usa 270 kHz, então sinais fracos que o app captaria podem voltar vazios.
Nossa opinião: como caderno de laboratório que permite a um agente rotular o que um Flipper escuta, é bem-feito, e roda inteiramente na sua máquina por stdio, sem porta de rede. Trate cada ferramenta de transmissão como um gatilho real, deixe o cliente configurado para perguntar antes de cada chamada e conte com manter seu próprio fork se uma atualização de firmware quebrar os plugins da CLI.
Onde ele se destaca
Um pentester preparando um trabalho de segurança física com escopo assinado
Levantar quais crachás e controles dentro do escopo usam códigos fixos
Leia cada crachá do escopo com rfid_read ou nfc_detect e identifique os controles com scan_and_identify; as notas de segurança do registro apontam protocolos de código fixo como o Princeton. Sem custo além do Flipper; mantenha cada captura dentro do escopo por escrito.
Um entusiasta de automação residencial com uma gaveta cheia de controles de 433 MHz
Descobrir qual protocolo cada um dos meus controles usa antes de ligá-lo a um hub
Rode scan_and_identify em 433.92 MHz enquanto aperta cada botão e depois flipper_file_inspect nos arquivos salvos. Controles de código variável que os decodificadores originais não reconhecem precisam de subghz_rx_raw ou de um firmware da comunidade.
Um professor de eletrônica com um Flipper na bancada do laboratório
Mostrar aos alunos como um controle infravermelho codifica comandos
Capture o controle da TV da sala de aula com ir_rx e reproduza o código NEC decodificado nessa mesma TV com ir_tx. Leva minutos e fica em equipamentos que pertencem à escola.
Antes de decidir
- Configuração
- Clone o repositório, crie um ambiente virtual com uv e instale em modo editável; depois rode flipper-smoke para confirmar que o Flipper foi encontrado. Registre o binário flipper-mcp com claude mcp add ou na configuração do Claude Desktop. Requer Python 3.11+ e um cabo USB-C de dados.
- Integrações
- Firmware oficial 1.4.x do Flipper Zero, com Momentum, RogueMaster e Xtreme previstos como compatíveis; um rádio CC1101 externo no conector GPIO via device=1 ou FLIPPER_DEFAULT_DEVICE. Uma CLI flipper-registry gerencia os arquivos de protocolo.
- Dados e privacidade
- Roda localmente por stdio e não abre nenhuma porta de rede. Capturas, arquivos do cartão SD e dados do aparelho vão para o seu provedor de modelos por meio do cliente. Os downloads do registro acessam a URL de índice que você informar; os protocolos instalados ficam em cache em ~/.local/share/flipper-mcp.
- Custo em escala
- Gratuito sob MIT. O único custo é o próprio Flipper Zero.
- Limites
- Só um programa pode ocupar a porta serial, então o qFlipper e a aba do Flipper Lab no navegador precisam estar fechados. Plugins da CLI desatualizados após uma atualização de firmware quebram os comandos ir, nfc e rfid. A CLI usa um filtro Sub-GHz de 650 kHz e não consegue trocar de preset.
O que é bom
- 54 ferramentas sobre a própria CLI do Flipper
- O registro de protocolos identifica 13 tipos comuns de sinal
- Roda localmente por stdio, sem porta de rede
- Macros abrem os apps de Sub-GHz, NFC e infravermelho em uma chamada
O que não é
- Ferramentas de transmissão, GPIO e CLI bruta não pedem confirmação
- Todos os commits chegaram em um único dia de abril de 2026
- A verificação de hash do registro remoto é opcional
- Instalação só por clone git; sem pacote no PyPI
Ideal para
Pesquisadores de segurança e entusiastas de hardware que têm um Flipper Zero e querem que um agente capture, rotule e catalogue sinais dos próprios aparelhos.
Alternativas ao flipper-mcp
flipper-mcp: perguntas frequentes
- flipper-mcp vale a pena?
- Uma ponte competente e honesta para um Flipper Zero que entrega ao agente o botão de transmitir sem uma segunda verificação, por isso só cabe numa bancada onde todos os aparelhos ao alcance são seus. Damos nota 3.5 de 5.
- Quanto custa flipper-mcp?
- Gratuito e de código aberto (MIT). Requer um Flipper Zero.
- Quais são as desvantagens de flipper-mcp?
- Ferramentas de transmissão, GPIO e CLI bruta não pedem confirmação; todos os commits chegaram em um único dia de abril de 2026; a verificação de hash do registro remoto é opcional; instalação só por clone git; sem pacote no PyPI.
- Para quem flipper-mcp é indicado?
- Pesquisadores de segurança e entusiastas de hardware que têm um Flipper Zero e querem que um agente capture, rotule e catalogue sinais dos próprios aparelhos.
- Quanto custa flipper-mcp para uma equipe ou em produção?
- Gratuito sob MIT. O único custo é o próprio Flipper Zero.
- flipper-mcp é seguro para dados da empresa?
- Roda localmente por stdio e não abre nenhuma porta de rede. Capturas, arquivos do cartão SD e dados do aparelho vão para o seu provedor de modelos por meio do cliente. Os downloads do registro acessam a URL de índice que você informar; os protocolos instalados ficam em cache em ~/.local/share/flipper-mcp.
- Quais são as melhores alternativas ao flipper-mcp?
- As alternativas mais próximas que analisamos são AetherLink SDR MCP.
Respostas verificadas em 14 de nov. de 2026.