Skip to main content
Glama
rsba1-mcp

rsba1-mcp

by fe1iscurc0r

rsba1-core

Pure Python implementation of the Icom RS-BA1 V2 protocol stack — control IC-705, IC-9700 and any CI-V transceiver over the network. No Icom binaries required.

License: MIT Python 3.11+ CI

What is this?

Icom's RS-BA1 software runs on Windows only and is closed-source. This project reverse-engineers the protocol and provides a pure Python replacement that runs anywhere Python runs.

Tested on: IC-705 (E2E verified 2026-08-18)

Related MCP server: copper-mountain-vna-mcp

Quick Start

pip install "rsba1-core[mcp]"   # MCP server needs fastmcp; plain CLI: pip install rsba1-core

export RADIO_HOST=192.168.0.31
export RADIO_USER=radio_user
export RADIO_PASSWORD=your_password

python -m rsba1.mcp read-freq
python -m rsba1.mcp set-freq 7074000

Platform Support

Platform

Network (radio-link)

Serial

Mailslot / CivCtrl.dll

Linux

✅ pure Python UDP

✅ [serial]

❌ Windows-only

macOS

✅ pure Python UDP

✅ [serial]

❌ Windows-only

Windows

✅ pure Python UDP

✅ [serial]

✅ legacy backends

The default radio-link backend is pure Python UDP — no Icom binaries, no DLLs, no pywin32. The Windows-only backends (--backend mailslot, CivCtrl.dll) live behind optional [windows] extras and are guarded so they never break imports or test collection on Linux/macOS. Serial support needs pyserial (pip install "rsba1-core[serial]").

MCP Server (for AI Agents)

python -m rsba1.mcp   # starts MCP server on stdio

Available tools: read_freq, read_mode, read_smeter, set_freq, ptt, get_status

Architecture

Your AI Agent / CLI
        ↓
rsba1-core (pure Python)
        ↓
IC-705 RS-BA1 server (UDP 50001 + 50002)

Key: no Windows APIs, no Icom DLLs, Python 3.11+ only.

Feature Status

Feature

Status

CI-V read (freq/mode/smeter)

✅ E2E verified

CI-V write (set_freq)

✅ E2E verified

PTT

✅ E2E verified

Audio streaming (UDP 50003)

❌ Not implemented

Documentation

License

MIT — see LICENSE and DISCLAIMER.md.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables control of Software Defined Radios and decoding of radio protocols through an AI-friendly Model Context Protocol interface, supporting RTL-SDR and HackRF hardware for signal analysis and protocol decoding.
      34
      37 PyPI
      31
      MIT
    • A
      license
      B
      quality
      A
      maintenance
      Enables AI agents to control Copper Mountain Vector Network Analyzers over TCP/IP SCPI, offering 45 tools for sweep configuration, calibration, measurement, and Touchstone export.
      49
      2
      AGPL 3.0
    • F
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to operate a Fishball7020/PlutoSky software-defined radio, including tuning, spectrum analysis, band scanning, IQ capture, FPGA filtering, and optional transmission.
      16
      4
      -