SDR MCP 서버

Model Context Protocol을 통한 소프트웨어 정의 라디오(SDR)용 대화형 AI 제어.

자연스러운 대화를 통해 RTL-SDR 하드웨어를 제어하세요. 스펙트럼 조회, 주파수 튜닝, 방송국 데이터베이스 탐색 및 실시간 워터폴 디스플레이 시각화가 가능합니다. Claude Desktop, 모든 MCP 클라이언트 또는 포함된 웹 대시보드와 함께 작동합니다.

빠른 시작

# Install
pip install sdr-mcp

# Check hardware
sdr-mcp check

# Start server (STDIO mode for Claude Desktop)
sdr-mcp serve

웹 대시보드 사용:

cd web_sota
npm install
npm run dev

문서

문서	내용
INSTALL.md	전체 설정, 드라이버, 구성
ARCHITECTURE.md	시스템 설계, 데이터 흐름, 전송
MCP_SERVER.md	예제가 포함된 17개의 모든 MCP 도구
SDR_TECHNOLOGY.md	초보자를 위한 라디오 기초
RTL_SDR_V4.md	권장 하드웨어 사양

기능

하드웨어 제어

RTL-SDR 장치 자동 감지, 초기화 및 구성
주파수 설정(24 MHz — 1.766 GHz), 게인(자동 또는 수동)
실시간 IQ 샘플 캡처 및 스펙트럼 처리

스펙트럼 분석

해밍 윈도우를 사용한 2048포인트 FFT
피크 감지 및 신호 강도 분석
시간 변화 신호를 위한 워터폴 기록(100라인)

주파수 데이터베이스

LW/MW/SW/VHF 대역에 걸쳐 사전 로드된 11개의 방송국
현재 재생 정보를 포함한 프로그램 일정
radio-browser.info를 통한 온라인 검색(25,000개 이상의 방송국)

WebSocket 스트리밍

웹 클라이언트로의 실시간 스펙트럼 브로드캐스트
WebSocket 명령을 통한 원격 주파수/게인 제어
캔버스 기반 스펙트럼 및 워터폴 시각화

웹 대시보드

스펙트럼 분석기 — 주파수/게인 제어 기능이 있는 라이브 FFT 플롯
워터폴 디스플레이 — 색상 코딩된 시간-주파수 시각화
방송국 브라우저 — 검색, 즐겨찾기, 대역 필터
온라인 DB — 이름/국가/장르별 radio-browser.info 쿼리
신호 ID — SigID Wiki에서 신호 유형 조회

하드웨어

권장: RTL-SDR Blog v4 (~$35)

24 MHz — 1.766 GHz 연속 커버리지
주파수 안정성을 위한 0.5 ppm TCXO
SMA 커넥터, 알루미늄 인클로저, 바이어스 티(bias tee)

RTL2832U 기반의 모든 SDR(R820T2 튜너 포함)이 작동합니다. 전체 사양은 RTL_SDR_V4.md를 참조하세요.

프로젝트 구조

sdr-mcp/
├── README.md              # This file
├── docs/                  # Documentation
│   ├── INSTALL.md         # Setup guide
│   ├── ARCHITECTURE.md    # System design
│   ├── MCP_SERVER.md      # Tool reference
│   ├── SDR_TECHNOLOGY.md  # Radio primer
│   └── RTL_SDR_V4.md      # Hardware specs
├── pyproject.toml         # Python package config
├── justfile               # Lint, fix, security recipes
├── start.ps1              # Launch backend + webapp
├── src/sdr_mcp/           # Python backend
│   ├── server.py          # FastMCP server, 17 tools
│   ├── capture.py         # RTL-SDR hardware interface
│   ├── processor.py       # FFT / spectrum processing
│   ├── frequency_db.py    # Station database
│   ├── online_db.py       # radio-browser.info API
│   ├── websocket_server.py # Real-time WebSocket stream
│   ├── transport.py       # STDIO / HTTP transport
│   └── cli.py             # Command-line interface
├── web_sota/              # React/TypeScript webapp
│   └── src/
│       ├── pages/         # Spectrum, Waterfall, Stations, etc.
│       └── components/    # Layout, UI components
└── tests/                 # Pytest test suite

기술 스택

계층	기술
프로토콜	FastMCP 3.2, MCP 2.14+
백엔드	Python 3.12, asyncio
하드웨어	pyrtlsdr, RtlSdr
신호	numpy, scipy (FFT)
스트리밍	websockets (RFC 6455)
프론트엔드	React 19, TypeScript, Vite
UI	Tailwind CSS, Radix UI, Lucide 아이콘
표준	Fleet SOTA, ruff, Biome, just

라이선스

MIT

SDR MCP Server

SDR MCP 서버

빠른 시작

문서

기능

하드웨어

프로젝트 구조

기술 스택

라이선스

Resources

Latest Blog Posts

MCP directory API