Skip to content
mcnanovna

Quick Start

Prerequisites

  • An MCP client (Claude Code, Cursor, Zed, or any MCP-compatible app)
  • NanoVNA-H connected via USB
  • Python 3.11+ (handled automatically by uvx)

Installation

  1. Add the MCP server to your client

    For Claude Code:

    Terminal window
    claude mcp add mcnanovna -- uvx mcnanovna

    For other clients, configure uvx mcnanovna as an MCP server per your client’s documentation.

  2. Start a new session

  3. Ask your assistant to use your VNA

    Try these prompts:

    • “Scan my antenna from 144 to 148 MHz”
    • “What’s the SWR at 145 MHz?”
    • “Analyze this filter’s frequency response”
    • “Capture a screenshot of the VNA display”

Verify Connection

Try: “Get VNA info”

You should see device details like firmware version, serial number, and frequency range.

Next Steps

Learn Your Hardware

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 →

Troubleshooting

VNA not detected

  1. Check USB connection
  2. Verify device appears as /dev/ttyACM0 (Linux) or COM port (Windows)
  3. Check permissions: sudo usermod -aG dialout $USER (Linux)

Permission denied

On Linux, add your user to the dialout group:

Terminal window
sudo usermod -aG dialout $USER
# Log out and back in for changes to take effect