Ryan Malloy
e21219be8d
- Starlight documentation for mcnanovna and mcpositioner - 19 pages covering tools, prompts, hardware, and tutorials - Docker deployment with dev/prod modes - Makefile for docker compose management - Custom SVG logos and hero illustration
71 lines
1.5 KiB
Plaintext
71 lines
1.5 KiB
Plaintext
---
|
|
title: Quick Start
|
|
description: Get mcnanovna running in 5 minutes
|
|
---
|
|
|
|
import { Steps, Tabs, TabItem, Aside } from '@astrojs/starlight/components';
|
|
|
|
## Prerequisites
|
|
|
|
- Claude Code CLI installed
|
|
- NanoVNA-H connected via USB
|
|
- Python 3.11+ (handled automatically by uvx)
|
|
|
|
## Installation
|
|
|
|
<Steps>
|
|
1. **Add the MCP server to Claude Code**
|
|
|
|
```bash
|
|
claude mcp add mcnanovna -- uvx mcnanovna
|
|
```
|
|
|
|
2. **Start a new Claude Code session**
|
|
|
|
```bash
|
|
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"
|
|
|
|
</Steps>
|
|
|
|
<Aside type="tip">
|
|
The VNA auto-connects on first tool call. No configuration needed if using default USB settings.
|
|
</Aside>
|
|
|
|
## Verify Connection
|
|
|
|
Ask Claude: "Get VNA info"
|
|
|
|
You should see device details like firmware version, serial number, and frequency range.
|
|
|
|
## Next Steps
|
|
|
|
- [Install mcpositioner](/mcpositioner/overview/) for automated antenna measurements
|
|
- [Run a calibration](/tutorials/calibration/) for accurate measurements
|
|
- [Explore all 78 tools](/mcnanovna/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:
|
|
|
|
```bash
|
|
sudo usermod -aG dialout $USER
|
|
# Log out and back in for changes to take effect
|
|
```
|