flipper-mcp의 개요
flipper-mcp는 GitHub 사용자 Str1ck9가 만든 것으로, Claude Code 같은 MCP 클라이언트를 USB로 연결한 Flipper Zero에 이어 줍니다. 각 도구는 Flipper 자체의 시리얼 명령줄에 명령을 보냅니다. Sub-GHz 주파수 수신, 원시 펄스 캡처, NFC·125 kHz RFID·iButton 태그 읽기, 적외선 코드 송신, SD 카드 파일 읽기와 쓰기, GPIO 핀 전환, 기기 버튼을 눌러 메뉴를 이동하는 일을 합니다.
MIT 라이선스의 Python으로 작성되었고, Python 3.11 이상이 필요하며 git clone으로 설치합니다. PyPI 패키지는 없습니다. GitHub 스타는 약 6개입니다. v0.5.0까지의 커밋 7개는 모두 2026년 4월 19일에 올라왔고, 그 뒤로 저장소는 바뀌지 않았습니다.
flipper-mcp 설치 방법
git clone https://github.com/Str1ck9/flipper-mcp && cd flipper-mcp && uv venv && uv pip install -e .flipper-mcp, 쓸 만한 가치가 있습니까?
flipper-mcp는 Flipper Zero를 54개의 MCP 도구로 바꿉니다. 각 도구가 실제 Flipper CLI 명령을 짧게 호출하는 방식이라 대부분 설명대로 작동합니다. README에 따르면 공식 펌웨어 1.4.x를 설치한 실제 하드웨어에서 검증했고, 커뮤니티 빌드인 Momentum, RogueMaster, Xtreme에서도 작동할 것으로 봅니다. 단순한 명령 래퍼 이상으로 만드는 것은 프로토콜 레지스트리입니다. Princeton 차고 리모컨부터 Security+ 2.0, EM4100 태그까지 13개 항목이 기본 포함되어 있고, 각각 대표 주파수, 일치 패턴, 알기 쉬운 보안 메모가 붙어 있습니다. 그래서 scan_and_identify가 신호를 캡처하고 무엇이 보냈는지 알려 줄 수 있습니다.
물리적인 측면은 분명히 말해 둘 필요가 있습니다. 이 서버는 무선 송신기를 제어합니다. subghz_tx_from_file은 저장된 .sub 캡처를 재전송하고, ir_tx와 ir_universal_send는 적외선 코드를 쏘며, gpio_write는 헤더의 핀을 구동하고, flipper_cli는 펌웨어가 받아들이는 모든 명령을 실행합니다. 저희가 server.py를 읽어 본 바로는 이 중 어느 것도 확인을 요청하지 않습니다. MCP 클라이언트 자체의 승인 프롬프트가 유일한 관문입니다. 출입문 리모컨 재전송, 출입증 복제, 다른 사람의 카드 읽기는 본인 소유이거나 테스트 권한을 받은 기 기에서만 허용되며, Sub-GHz 송신은 펌웨어가 적용하는 지역별 대역 규정의 제한을 받습니다.
주의할 점: 이것은 하루 만에 만든 프로젝트입니다. 2026년 4월 19일의 커밋 7개로 첫 릴리스에서 v0.5.0까지 왔고, 그 뒤 몇 달 동안 아무것도 추가되지 않았으며 PyPI 릴리스도 없습니다. 원격 레지스트리는 사용자가 지정한 어떤 인덱스 URL에서든 프로토콜 파일을 내려받고, SHA-256 검사는 인덱스가 해시를 제공할 때만 실행됩니다. 또한 기본 펌웨어의 CLI는 650 kHz 필터로 수신하는 반면 기기의 Read 앱은 270 kHz를 사용하므로, 앱이라면 잡았을 약한 신호가 빈 결과로 돌아올 수 있습니다.
결론: Flipper가 듣는 것에 에이전트가 이름을 붙이게 하는 실험 노트로서는 잘 만들어졌고, stdio를 통해 전적으로 사용자의 컴퓨터에서 실행되며 네트워크 포트를 열지 않습니다. 모든 송신 도구는 실제 방아쇠로 취급하고, 클라이언트는 호출할 때마다 묻도록 설정해 두어야 하며, 펌웨어 업데이트로 CLI 플러그인이 깨지면 직접 포크를 유지할 각오를 해야 합니다.
제 역할을 하는 곳
서명된 범위로 물리 보안 점검을 준비하는 침투 테스터
범위 안의 출입증과 리모컨 중 고정 코드를 쓰는 것을 파악하기
범위 안의 출입증을 하나씩 rfid_read나 nfc_detect로 읽고, 리모컨은 scan_and_identify로 식별합니다. 레지스트리의 보안 메모가 Princeton 같은 고정 코드 프로토콜을 표시합니다. Flipper 외에는 비용이 들지 않 으며, 모든 캡처는 서면으로 정한 범위 안에서만 해야 합니다.
433 MHz 리모컨이 서랍 가득한 홈 오토메이션 애호가
허브에 연결하기 전에 내 리모컨이 각각 어떤 프로토콜을 쓰는지 알아내기
버튼을 하나씩 누르면서 433.92 MHz에서 scan_and_identify를 실행한 뒤, 저장된 파일에 flipper_file_inspect를 돌립니다. 기본 디코더가 놓치는 롤링 코드 리모컨에는 subghz_rx_raw나 커뮤니티 펌웨어가 필요합니다.
실험실 작업대에 Flipper를 둔 전자공학 교사
적외선 리모컨이 명령을 어떻게 부호화하는지 학생들에게 보여 주기
교실 TV 리모컨을 ir_rx로 캡처한 다음, 디코딩한 NEC 코드를 ir_tx로 같은 TV에 재전송합니다. 몇 분이면 끝나고 학교 소유 장비 안에서만 이루어집니다.
도입 전 확인할 점
- 설정
- 저장소를 복제하고 uv로 가상 환경을 만든 뒤 편집 가능 모드로 설치하고, flipper-smoke를 실행해 Flipper가 인식되는지 확인합니다. flipper-mcp 바이너리를 claude mcp add나 Claude Desktop 설정에 등록합니다. Python 3.11+와 데이터 전송용 USB-C 케이블이 필요합니다.
- 연동
- Flipper Zero 공식 펌웨어 1.4.x를 지원하며 Momentum, RogueMaster, Xtreme도 작동할 것으로 예상됩니다. GPIO 헤더에 연결한 외부 CC1101 무선 모듈은 device=1 또는 FLIPPER_DEFAULT_DEVICE로 사용합니다. flipper-registry CLI가 프로토콜 파일을 관리합니다.
- 데이터와 개인정보
- stdio로 로컬에서 실행되며 네트워크 포트를 열지 않습니다. 캡처, SD 카드 파일, 기기 정보는 클라이언트를 거쳐 모델 제공업체로 전달됩니다. 레지스트리 다운로드는 사용자가 지정한 인덱스 URL에 접속하며, 설치된 프로토콜은 ~/.local/share/flipper-mcp에 캐시됩니다.
- 대규모 사용 시 비용
- MIT 라이선스로 무료입니다. 비용은 Flipper Zero 본체뿐입니다.
- 제한
- 시리얼 포트는 한 프로그램만 쓸 수 있으므로 qFlipper와 브라우저의 Flipper Lab 탭을 닫아야 합니다. 펌웨어 업데이트 후 오래된 CLI 플러그인이 남아 있으면 ir, nfc, rfid 명령이 작동하지 않습니다. CLI는 650 kHz Sub-GHz 필터를 사용하며 프리셋을 바꿀 수 없습니다.
좋은 점
- Flipper 자체 CLI 위에서 작동하는 도구 54개
- 프로토콜 레지스트리가 흔한 신호 유형 13가지를 식별
- stdio로 로컬에서 실행되며 네트워크 포트 없음
- 매크로로 Sub-GHz, NFC, 적외선 앱을 한 번의 호출로 실행
아쉬운 점
- 송신, GPIO, 원시 CLI 도구에 확인 절차가 없음
- 모든 커밋이 2026년 4월 하루에 몰림
- 원격 레지스트리 해시 검사는 선택 사항
- git clone으로만 설치 가능하며 PyPI 패키지 없음
추천 대상
Flipper Zero를 갖고 있고, 에이전트가 자기 기기의 신호를 캡처하고 이름 붙이고 정리하기를 원하는 보안 연구자와 하드웨어 애호가.
flipper-mcp 대안
flipper-mcp: 자주 묻는 질문
- flipper-mcp, 쓸 만한 가치가 있습니까?
- Flipper Zero로 이어지는 유능하고 정직한 다리이지만, 두 번째 확인 없이 에이전트에게 송신 버튼을 넘깁니다. 따라서 범위 안의 모든 기기가 자신의 것인 작업대에서만 써야 합니다. 평점은 5점 만점에 3.5점입니다.
- flipper-mcp의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다. Flipper Zero가 필요합니다.
- flipper-mcp의 단점은 무엇입니까?
- 송신, GPIO, 원시 CLI 도구에 확인 절차가 없음; 모든 커밋이 2026년 4월 하루에 몰림; 원격 레지스트리 해시 검사는 선택 사항; git clone으로만 설치 가능하며 PyPI 패키지 없음.
- flipper-mcp에 적합한 사람은 누구입니까?
- Flipper Zero를 갖고 있고, 에이전트가 자기 기기의 신호를 캡처하고 이름 붙이고 정리하기를 원하는 보안 연구자와 하드웨어 애호가.
- 팀이나 프로덕션 환경에서 flipper-mcp의 비용은 얼마입니까?
- MIT 라이선스로 무료입니다. 비용은 Flipper Zero 본체뿐입니다.
- flipper-mcp에 회사 데이터를 맡겨도 안전합니까?
- stdio로 로컬에서 실행되며 네트워크 포트를 열지 않습니다. 캡처, SD 카드 파일, 기기 정보는 클라이언트를 거쳐 모델 제공업체로 전달됩니다. 레지스트리 다운로드는 사용자가 지정한 인덱스 URL에 접속하며, 설치된 프로토콜은 ~/.local/share/flipper-mcp에 캐시됩니다.
- flipper-mcp의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 AetherLink SDR MCP입니다.
답변 확인일: 2026년 11월 14일.