Quick Start

Prerequisites

• Claude Code CLI installed
• NanoVNA-H connected via USB
• Python 3.11+ (handled automatically by uvx)

Installation

1. Add the MCP server to Claude Code

   claude mcp add mcnanovna -- uvx mcnanovna

2. Start a new Claude Code session

   claude

3. Ask Claude 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”

Tip

The VNA auto-connects on first tool call. No configuration needed if using default USB settings.

Verify Connection

Ask Claude: “Get VNA info”

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

Next Steps

• Install mcpositioner for automated antenna measurements
• Run a calibration for accurate measurements
• Explore all 78 tools

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:

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