Skip to content
mcnanovna

mcnanovna

MCP servers for RF test equipment automation
Get Started View on Gitea

What is this?

Two MCP servers that let LLMs control RF test equipment:

mcnanovna

Controls NanoVNA-H vector network analyzers over USB serial. 78 tools for sweeps, calibration, analysis, and 3D radiation patterns.

mcpositioner

Controls ESP32 dual-axis antenna positioners over WiFi. 5 tools for stepper motor positioning and automated measurement grids.

Cross-Server Workflows

Both servers work together for automated 3D antenna pattern measurement. Your assistant orchestrates positioning and VNA measurements across the grid.

Web UI

Optional Three.js 3D viewer for radiation patterns. Real-time visualization as measurements are taken.

What Can It Do?

Direct access to professional RF measurement capabilities:

Smith chart display showing impedance plot
Impedance analysis on Smith chart
SWR measurement trace
SWR sweep across frequency
LC matching network calculation
Automatic LC match calculation
Multiple trace display
Multi-trace S-parameter display

Quick Install

Terminal window
# Add both servers (Claude Code example)
claude mcp add mcnanovna -- uvx mcnanovna
claude mcp add mcpositioner -- uvx mcpositioner

Then ask your assistant to analyze your antenna, measure a filter, or run a 3D pattern sweep.

Hardware

NanoVNA-H

The NanoVNA-H (or H4) connects via USB serial and is auto-detected. No drivers needed on Linux — just plug in and go. See the NanoVNA-H reference site for hardware details.

ESP32 Positioner

Optional dual-axis antenna positioner for automated 3D pattern measurement:

  • 2x NEMA 17 steppers + TMC2209 drivers
  • StallGuard sensorless homing
  • WiFi HTTP API for remote control
  • Firmware and KiCad schematics included
NanoVNA-H vector network analyzer
NanoVNA-H — 50kHz to 1.5GHz VNA

Hardware Documentation

NanoVNA-H

600 Hz – 2 GHz

Open-source hardware reference. Firmware internals, calibration theory, 60 shell commands.

nanovna-h.warehack.ing →

NanoVNA-F V3

1 MHz – 6 GHz

Extended-range hardware reference. Measurement guides, antenna testing, TDR, data export.

nanovna-f.warehack.ing →

Example Prompts

Once installed, try prompts like:

  • “Connect to my NanoVNA and sweep 7.0-7.3 MHz to check my 40m dipole”
  • “Measure the insertion loss of this BPF from 144-148 MHz”
  • “What’s the impedance at the resonant frequency? Suggest an LC match.”
  • “Run a 3D radiation pattern sweep at 15° resolution”
  • “Export the S11 data as a Touchstone file”