Rs Spectrum Analyzer

CI License Python 3.10+ MCP eng-mcp-suite

Drive Rohde & Schwarz spectrum and signal analyzers from any MCP-compatible AI client. TCP or VISA: 62 tools spanning frequency, bandwidth, markers, measurements (ACLR / OBW / SEM / EVM / CCDF), traces, limits, and templates.

Quick start · Tools · Workflows · Documentation

[!IMPORTANT] Hardware required for real measurements. This MCP server controls real spectrum analyzers over SCPI (TCP or VISA). You need actual R&S FSW / FSVA / FSV / FPL hardware (or a supported Keysight / Rigol / Siglent analyzer) on the network or USB-connected to measure anything. For development and offline work there is now a simulator: spectrum-simulator serves a SCPI command table on port 5025 so the tools can be exercised with no bench attached. It produces synthetic values: anything measured against it is measuring nothing.

What is mcp-rs-spectrum-analyzer?

mcp-rs-spectrum-analyzer is a Model Context Protocol server that automates spectrum and signal analyzers over SCPI. Connect any MCP-compatible AI assistant (Claude Desktop, Claude Code, VS Code Copilot, …) to your test equipment for hands-free RF measurements, EMC pre-compliance testing, and automated test sequences.

Primary target is the R&S FSW / FSVA3000 / FSV3000 / FPL1000 family (vendor-specific result parsing, family detection). A common SCPI core also covers Keysight (N90x0/UXA/PXA/MXA/EXA/CXA), Rigol (DSA800/RSA5000/RSA3000), Siglent (SSA3000X/SVA1000X), Anritsu (MS2760/MS2090), and Tektronix (RSA500/RSA600). All vendors share ~95% identical SCPI command sets.

What mcp-rs-spectrum-analyzer does well:

• 🤖 AI-native via MCP. First-class Model Context Protocol server with 62 tools across 14 categories. Any Claude / LLM agent can drive it.
• 🐍 Python + MCP surfaces. Direct driver access via import spectrum_analyzer_mcp, or run as an MCP server for AI-agent automation.
• ⚡ Two transports, shared with the sibling R&S servers. Raw TCP/IP sockets (no VISA install needed) or PyVISA for GPIB / USB-TMC / HiSLIP, both from scpi-core. The socket transport holds each query's send and read under one lock and refuses a stream a timed-out read may have left offset. The failure mode that otherwise returns the previous answer with no error.
• 🧪 Offline simulator. spectrum-simulator plus fault injection (--drop-responses, --slow-response-ms, --close-after) so timeout and desync handling can be exercised deliberately.
• ✅ Pre-built measurement templates. Channel power, ACLR, OBW, EMI (CISPR 32 Class B), harmonics, spurious.
• 🔒 AGPL-3.0-or-later. SCPI-injection-guarded, path-traversal-protected, raw-SCPI disable flag.

Quick start

Install

uv pip install -e .

# Optional: VISA support for GPIB/USB/HiSLIP
uv pip install -e ".[visa]"

# Optional: the offline simulator
uv pip install -e ".[sim]"

Run without hardware

spectrum-simulator                     # listens on 127.0.0.1:5025
spectrum-simulator --list-unverified   # nodes not yet confirmed on hardware

Configure

Set your instrument's address via environment variable or .env file:

export SA_HOST=192.168.1.100
export SA_PORT=5025         # 5025 for R&S / Keysight / Siglent; 5555 for Rigol

Two surfaces, same answer

import asyncio
from spectrum_analyzer_mcp.driver import SpectrumAnalyzerDriver

async def main():
    async with SpectrumAnalyzerDriver("192.168.1.100", 5025) as sa:
        await sa.set_center_span(1e9, 100e6)
        await sa.set_reference_level(0)
        await sa.set_rbw(100e3)
        peak = await sa.peak_search()
        print(f"Peak: {peak.frequency_hz/1e9:.4f} GHz @ {peak.amplitude_dbm:.2f} dBm")

asyncio.run(main())

{
  "mcpServers": {
    "spectrum-analyzer": {
      "command": "spectrum-analyzer-mcp"
    }
  }
}

{
  "mcpServers": {
    "spectrum-analyzer": {
      "command": "uv",
      "args": ["run", "--directory",
               "/path/to/mcp-rs-spectrum-analyzer",
               "spectrum-analyzer-mcp"]
    }
  }
}

VISA connections

For instruments connected via GPIB, USB-TMC, or HiSLIP (requires pyvisa):

# GPIB
await sa.connect(resource="GPIB::1::INSTR")
# USB-TMC
await sa.connect(resource="USB::0x0AAD::0x0119::100001::INSTR")
# HiSLIP
await sa.connect(resource="TCPIP::192.168.1.100::hislip0::INSTR")

Tools

62 MCP tools, grouped:

Built-in templates: channel_power, aclr, obw, emi (CISPR 32 Class B), harmonics, spurious. Full reference in docs/tools.md.

Supported instruments

Full support = vendor-specific result parsing and family detection. SCPI core = standard SCPI for frequency / amplitude / markers / trace / sweep. All vendors share 95%+ identical SCPI command sets.

Security

• SCPI injection protection. All user-supplied parameters sanitized before inclusion in SCPI commands.
• Path-traversal protection: file-export paths validated against configured safe directories.
• Raw SCPI guard: sa_scpi_send / sa_scpi_query can be disabled via SA_RAW_SCPI_ENABLED=false.
• Serialized shared state: measurement, template and state each hold their own asyncio lock; live analyzer connections are held by a shared connection registry with an idle TTL and a single eviction path.
• State rollback: failed state restore operations automatically roll back to the previous state.

Workflows

mcp-rs-spectrum-analyzer fits in the following eng-mcp-suite workflow bundles:

• lab-automation: pair with copper-mountain-vna-mcp, mcp-rs-siggen, and mcp-rs-cmw500 for end-to-end RF bench-test workflows driven from a single agent session.
• emc-precompliance: drive ACLR / OBW / SEM measurements while mcp-emc-regulations supplies CISPR / FCC limits.

eng-mcp-suite install --workflow lab-automation

Documentation

• 📘 Quick Start: install through first call.
• 🛠️ Tool reference. Every MCP tool, every argument.
• 📐 Usage examples. An EMC pre-compliance walkthrough.
• 🏗️ Architecture: how this MCP fits in eng-mcp-suite.
• 📝 Changelog

Part of eng-mcp-suite

_{This MCP server is part of}

eng-mcp-suite

_{Part of eng-mcp-suite. An open umbrella of MCP servers for RF / EMC / PCB / signal-integrity engineering. Drop into the lab-automation workflow bundle with eng-mcp-suite install --workflow lab-automation.}

Development

uv pip install -e ".[dev]"

uv run pytest tests/ -v          # 250 tests
uv run ruff check src/ tests/
uv run ruff format --check src/ tests/
uv run mypy src/

License

AGPL-3.0-or-later. Relicensed from Apache-2.0 in v0.3.0 to align with the eng-mcp-suite toolkit-wide AGPL move.

Trademarks and brand assets

This project is not affiliated with, endorsed by, or sponsored by Rohde & Schwarz GmbH & Co. KG. "Rohde & Schwarz" is a trademark of Rohde & Schwarz GmbH & Co. KG. It is used here only to identify the instruments this project interoperates with.

The project name and the logo files in this repository are not part of the licensed work. The licence above grants no permission to use them, except as needed to describe the origin of the work.

Acknowledgments

• Rohde & Schwarz: for thorough SCPI documentation of the FSW / FSVA / FSV / FPL families.
• The MCP working group: for the Model Context Protocol specification.