Price Per TokenPrice Per Token
Oscilloscope and Function Generator Server

Oscilloscope and Function Generator Server

by manasp21

GitHub 2 432 uses Remote
0

About

Oscilloscope MCP Server equips AI agents with professional signal acquisition, analysis, and waveform generation capabilities for hardware testing and embedded systems debugging. It interfaces with Windows microphones for real-time audio analysis or runs in simulation mode for development workflows. Key capabilities include: - **Multi-channel Signal Acquisition**: 4-channel oscilloscope with configurable sample rates, capturing from Windows microphones or simulated hardware sources - **Real-time Spectrum Analysis**: FFT processing with multiple windowing functions for harmonic analysis and frequency domain characterization - **Protocol Decoding**: Digital signal analysis for UART, SPI, I2C, and CAN bus embedded communications - **Function Generation**: Synthesis of sine, square, triangle, sawtooth, and noise waveforms with configurable frequency, amplitude, and duration - **Automated Measurements**: RMS, peak-to-peak, frequency, and amplitude analysis with over 40 integrated measurement functions - **Claude Desktop Integration**: Windows-compatible MCP tools for automated test workflows and instrument control

README

Oscilloscope MCP Server with Microphone Integration

A professional oscilloscope and function generator MCP (Model Context Protocol) server that provides comprehensive signal processing and measurement capabilities to AI agents like Claude Desktop. Now with Windows microphone support for real-time audio analysis!

Features

Oscilloscope Capabilities

  • Multi-channel acquisition (4 channels, configurable sample rates)
  • Real-time microphone input for Windows audio analysis
  • Advanced FFT analysis with windowing functions
  • Automated measurements (RMS, frequency, amplitude, etc.)
  • Protocol decoding (UART, SPI, I2C, CAN)
  • Signal processing with spectrum analysis
  • Function Generator Capabilities

  • Standard waveforms (sine, square, triangle, sawtooth, noise)
  • Configurable parameters (frequency, amplitude, duration)
  • Test signal injection for calibration and testing
  • Dual-channel output simulation
  • MCP Integration

  • 9 MCP tools for instrument control and analysis
  • 3 resource endpoints for real-time data access
  • 2 workflow prompts for guided setup
  • Claude Desktop compatibility with Windows integration
  • Hardware Interface Support

  • Simulation mode - Mock data for development
  • Microphone mode - Real-time Windows audio capture
  • USB/Ethernet/PCIe - Professional ADC hardware support
  • Architecture

    The server uses a modular TypeScript architecture with:

  • Hardware Interface Layer: Abstracts simulation and real hardware
  • Signal Processing Engine: FFT, filtering, and analysis algorithms
  • MCP Server Core: Exposes functionality through MCP protocol
  • Data Store: Handles acquisition storage and caching
  • Measurement Engine: Automated parameter analysis
  • Protocol Decoders: Digital communication analysis
  • Quick Start (Windows + Claude Desktop)

    Prerequisites

  • Windows 10/11 with working microphone
  • Node.js (version 18 or higher)
  • Claude Desktop
  • Installation

    1. Clone and install
       git clone https://github.com/oscilloscope-mcp/oscilloscope-mcp.git
       cd oscilloscope-mcp
       npm install
       

    2. Build the project

       npm run build
       

    3. Start the server

       .\start-mcp-server.ps1
       

    4. Configure Claude Desktop - Open %APPDATA%\Roaming\Claude\claude_desktop_config.json - Add the server configuration (see WINDOWS_SETUP.md)

    Testing Your Setup

    In Claude Desktop, try these commands:
  • "Check the hardware status of the oscilloscope server"
  • "List available audio devices"
  • "Capture 3 seconds of audio from my microphone and analyze it"
  • MCP Tools Available

    Oscilloscope Tools

  • get_acquisition_status - Check current acquisition status
  • acquire_waveform - Capture data from microphone or simulation
  • measure_parameters - Automated signal measurements
  • analyze_spectrum - FFT analysis with windowing
  • Function Generator Tools

  • generate_test_signal - Create calibration signals
  • Device Management Tools

  • list_audio_devices - Enumerate available audio devices
  • configure_hardware - Change hardware settings
  • get_hardware_status - Get current configuration
  • Analysis Tools

  • decode_protocol - Decode digital communication protocols
  • Usage Examples

    Basic Microphone Analysis

    1. configure_hardware(hardware_interface="microphone", audio_sample_rate=44100)
    2. acquire_waveform(timeout=5.0, channels=[0])
    3. measure_parameters(acquisition_id="...", measurements=["frequency", "amplitude", "rms"])
    4. analyze_spectrum(acquisition_id="...", window="hamming")
    

    Device Selection

    1. list_audio_devices()
    2. configure_hardware(hardware_interface="microphone", microphone_device="USB Audio")
    3. get_hardware_status()
    

    Signal Generation and Testing

    1. generate_test_signal(signal_type="sine", frequency=1000, amplitude=1.0)
    2. analyze_spectrum(acquisition_id="test_...", resolution=1024)
    

    Hardware Interface Configuration

    Microphone Mode (Default for Windows)

  • Real-time audio capture from system microphone
  • Configurable sample rates (22050, 44100, 48000, 96000 Hz)
  • Device selection from available audio inputs
  • Multi-channel simulation from mono input
  • Simulation Mode

  • Realistic signal generation with noise
  • No hardware required for development
  • Full feature support for testing
  • Professional Hardware

  • USB/Ethernet/PCIe support for ADC devices
  • High-speed data acquisition capabilities
  • Real-time processing support
  • Configuration Options

    Hardware Interface Types

    - "simulation" - Mock data for testing
    
  • "microphone" - Windows audio capture
  • "usb" - USB-based ADC devices
  • "ethernet" - Network-connected ADCs
  • "pcie" - PCIe ADC cards
  • Audio Sample Rates

    ```typescript
  • 22050 - Basic quality
  • 44100 - CD quality (recommended)
  • 4
  • Related MCP Servers

    AI Research Assistant

    AI Research Assistant

    hamid-vakilzadeh

    AI Research Assistant provides comprehensive access to millions of academic papers through the Semantic Scholar and arXiv databases. This MCP server enables AI coding assistants to perform intelligent literature searches, citation network analysis, and paper content extraction without requiring an API key. Key features include: - Advanced paper search with multi-filter support by year ranges, citation thresholds, field of study, and publication type - Title matching with confidence scoring for finding specific papers - Batch operations supporting up to 500 papers per request - Citation analysis and network exploration for understanding research relationships - Full-text PDF extraction from arXiv and Wiley open-access content (Wiley TDM token required for institutional access) - Rate limits of 100 requests per 5 minutes with options to request higher limits through Semantic Scholar

    Web & Search
    12 8
    Linkup

    Linkup

    LinkupPlatform

    Linkup is a real-time web search and content extraction service that enables AI assistants to search the web and retrieve information from trusted sources. It provides source-backed answers with citations, making it ideal for fact-checking, news gathering, and research tasks. Key features of Linkup: - Real-time web search using natural language queries to find current information, news, and data - Page fetching to extract and read content from any webpage URL - Search depth modes: Standard for direct-answer queries and Deep for complex research across multiple sources - Source-backed results with citations and context from relevant, trustworthy websites - JavaScript rendering support for accessing dynamic content on JavaScript-heavy pages

    Web & Search
    2 24
    Math-MCP

    Math-MCP

    EthanHenrickson

    Math-MCP is a computation server that enables Large Language Models (LLMs) to perform accurate numerical calculations through the Model Context Protocol. It provides precise mathematical operations via a simple API to overcome LLM limitations in arithmetic and statistical reasoning. Key features of Math-MCP: - Basic arithmetic operations: addition, subtraction, multiplication, division, modulo, and bulk summation - Statistical analysis functions: mean, median, mode, minimum, and maximum calculations - Rounding utilities: floor, ceiling, and nearest integer rounding - Trigonometric functions: sine, cosine, tangent, and their inverses with degrees and radians conversion support

    Developer Tools
    22 81