GNU Radio MCP 서버 (gr-mcp)

gr-mcp는 GNU Radio 흐름 그래프(flowgraph) 작업을 AI 어시스턴트 및 자동화 클라이언트를 위한 도구로 노출하는 MCP 서버입니다. FastMCP를 기반으로 구축되었으며 프로그래밍 방식의 SDR 워크플로우 생성, 편집, 검증 및 내보내기를 위해 설계되었습니다.

제공 기능

• 사용 가능한 GNU Radio 블록 탐색

• 프로그래밍 방식의 블록 생성 및 제거

• 블록 매개변수 읽기/쓰기 작업

• 블록 간 연결 및 연결 해제

• 흐름 그래프 검증 및 오류 검사

• .grc 파일로 흐름 그래프 저장

Related MCP server: Crowdlistening

요구 사항

• Python >=3.13

• GNU Radio가 설치되어 있고 Python에서 사용 가능해야 함 (GNU Radio Companion 3.10.12.0으로 테스트됨)

• uv

설치

1. 저장소를 복제합니다:

git clone https://github.com/yoelbassin/gr-mcp
cd gr-mcp

2. GNU Radio가 설치되어 있지 않다면 설치합니다:

• GNU Radio 설치 가이드

3. 시스템 GNU Radio 패키지를 인식할 수 있는 가상 환경을 생성합니다:

uv venv --system-site-packages

GNU Radio는 일반적으로 시스템 수준의 Python 패키지로 설치되므로 --system-site-packages 플래그가 필요합니다.

MCP 클라이언트로 실행

MCP 클라이언트 구성(예: Cursor 또는 Claude Desktop)에 gr-mcp를 추가합니다:

{
  "mcpServers": {
    "gr-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/gr-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

개발

개발 의존성을 설치하고 테스트를 실행합니다:

pip install -e ".[dev]"
pytest

프로젝트 상태

이 프로젝트는 활발히 개발 중입니다. 핵심 기능은 사용할 수 있으며, 서버가 성숙해짐에 따라 인터페이스가 변경될 수 있습니다.