仪器控制MCP服务器

Digilent Discovery MCP Server

An MCP server that exposes Digilent DWF SDK instruments as tools for LLM-based agents.

Connect an Analog Discovery 2, Digital Discovery, or other Digilent device and let AI agents directly control oscilloscopes, waveform generators, logic analyzers, power supplies, DMMs, and protocol interfaces (UART, SPI, I2C).

Prerequisites

• Go 1.25+
• Digilent DWF SDK — install the Adept Runtime and WaveForms so that libdwf is available on your system
• A supported Digilent device connected via USB

Supported Devices

Build

go build -o discovery-mcp .

Usage

Transport Modes

# stdio (default) — for MCP clients like Claude Desktop
./discovery-mcp

# SSE — Server-Sent Events on HTTP
./discovery-mcp --transport sse --host localhost --port 8080

# Streamable HTTP
./discovery-mcp --transport http --host localhost --port 8080

Device Check

Verify device connectivity and inspect available configurations:

./discovery-mcp --check

Example output:

Enumerated Devices: 1
  0) Analog Discovery 2 (Discovery2)      SN:210321A197E9       available

Only one device connected, opening it...

Device Info:
  Name:                Analog Discovery 2
  Serial Number:       SN:210321A1B2C3
  SDK Version:         3.20.1
  Analog In Channels:  2
  Analog Out Channels: 2
  Digital In Channels: 16
  Digital Out Channels:16
  Max Buffer Size:     8192
  ADC Resolution:      14 bits
  Board Temperature:   38.2 °C

Available Configurations (8):
  --------------------------------------------------------------------------------------
  Config  AI-Ch  AO-Ch  IO-Ch  DI-Ch  DO-Ch  DIO    AI-Buf   AO-Buf   DI-Buf   DO-Buf  
  --------------------------------------------------------------------------------------
    0       2      2      2      16    16    16     8192     4096     4096     1024    
    1       2      2      2      16    0     16     16384    1024     1024     0    
  ...

CLI Flags

MCP Client Configuration

Add this to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "discovery": {
      "command": "/path/to/discovery-mcp"
    }
  }
}

For SSE mode, point your client to http://localhost:8080/sse.

MCP Tools Reference

Device

discovery_enumerate

List all connected Digilent devices and their serial numbers/IDs. No parameters.

Returns: List of available devices with their index and status.

discovery_device_get_configs

List available hardware configurations for a specific device index.

Returns: List of configurations with channel counts and buffer sizes.

discovery_device_open

Open a connection to a Digilent DWF device. Must be called before using any instrument.

Returns: Device info including name, serial number, channel counts, buffer sizes, and ADC resolution.

discovery_device_close

Close the connection to the device and free all resources. No parameters.

discovery_device_temperature

Read the on-board temperature sensor. No parameters.

Returns: Temperature in °C. Not all devices have a temperature sensor.

Oscilloscope

discovery_scope_open

Initialize the oscilloscope instrument with acquisition parameters.

discovery_scope_measure

Take a single instantaneous voltage reading.

Returns: Voltage in Volts.

discovery_scope_trigger

Configure the oscilloscope trigger for edge-triggered acquisition.

discovery_scope_record

Capture a full buffer of analog samples. Configure the oscilloscope and optionally set a trigger before calling this.

Returns: JSON with sample count, min/max values, and the full data array.

discovery_scope_close

Reset the oscilloscope instrument. No parameters.

Wavegen

discovery_wavegen_generate

Generate an analog waveform on a wavegen channel.

discovery_wavegen_enable / discovery_wavegen_disable

Enable or disable output on a wavegen channel.

discovery_wavegen_close

Reset a wavegen channel.

Power Supplies

discovery_supplies_switch

Configure and enable/disable the onboard power supply rails (V+, V−, VDD/6V).

discovery_supplies_close

Reset all power supplies. No parameters.

Digital Multimeter

Note: DMM is only available on certain devices (e.g. Analog Discovery Pro).

discovery_dmm_open

Initialize the DMM instrument. No parameters.

discovery_dmm_measure

Perform a DMM measurement.

Returns: Measured value with appropriate unit.

discovery_dmm_close

Reset the DMM. No parameters.

Logic Analyzer

discovery_logic_open

Initialize the logic analyzer.

discovery_logic_trigger

Configure the logic analyzer trigger.

discovery_logic_record

Capture digital samples from a DIO channel.

Returns: JSON with sample count and the data array.

discovery_logic_close

Reset the logic analyzer. No parameters.

Pattern Generator

discovery_pattern_generate

Generate a digital pattern on a DIO line.

discovery_pattern_enable / discovery_pattern_disable

Enable or disable a digital output.

discovery_pattern_close

Reset the pattern generator. No parameters.

Static I/O

discovery_static_set_mode

Configure a DIO line as input or output.

discovery_static_get_state

Read the current state of a DIO line.

Returns: true (HIGH) or false (LOW).

discovery_static_set_state

Set a DIO line high or low.

discovery_static_close

Reset static I/O. No parameters.

UART

discovery_uart_open

Initialize UART communication on DIO lines.

discovery_uart_read

Read available data from the UART RX buffer. No parameters.

Returns: Received bytes as a string.

discovery_uart_write

Send data through UART TX.

discovery_uart_close

Reset the UART interface. No parameters.

SPI

discovery_spi_open

Initialize SPI communication.

discovery_spi_read

Read bytes from SPI.

discovery_spi_write

Write data through SPI.

discovery_spi_close

Reset the SPI interface. No parameters.

I2C

discovery_i2c_open

Initialize I2C communication.

discovery_i2c_scan

Scan the I2C bus for connected devices (probes addresses 0x08–0x77). No parameters.

Returns: List of found 7-bit addresses.

discovery_i2c_read

Read bytes from an I2C device.

discovery_i2c_write

Write data to an I2C device.

discovery_i2c_close

Reset the I2C interface. No parameters.

Examples

Measure a DC Voltage

Open the device and take a quick voltage reading from oscilloscope channel 1:

1. discovery_device_open  → { "device": "", "config": 0 }
2. discovery_scope_open   → { "sampling_frequency": 20000000, "amplitude_range": 5 }
3. discovery_scope_measure → { "channel": 1 }
   ← "3.312500 V on channel 1"
4. discovery_scope_close
5. discovery_device_close

Record a Triggered Waveform

Capture a 1 kHz signal with rising-edge trigger at 1.5 V:

1. discovery_device_open   → { "config": 0 }
2. discovery_scope_open    → { "sampling_frequency": 1000000, "buffer_size": 8192 }
3. discovery_scope_trigger → { "enable": true, "source": 2, "channel": 1,
                               "edge_rising": true, "level": 1.5, "timeout": 5 }
4. discovery_scope_record  → { "channel": 1 }
   ← { "samples": 8192, "min": -1.65, "max": 1.65, "data": [...] }
5. discovery_scope_close
6. discovery_device_close

Generate a 1 kHz Sine Wave

Output a 1 kHz sine wave at 2 V amplitude on wavegen channel 1:

1. discovery_device_open       → { "config": 0 }
2. discovery_wavegen_generate  → { "channel": 1, "function": 1,
                                   "frequency": 1000, "amplitude": 2 }
   ← "Waveform started on channel 1"
   ... (signal is now outputting) ...
3. discovery_wavegen_disable   → { "channel": 1 }
4. discovery_wavegen_close     → { "channel": 1 }
5. discovery_device_close

Power Supply Control

Enable +5 V supply with 100 mA limit:

1. discovery_device_open     → { "config": 0 }
2. discovery_supplies_switch → { "master_state": true,
                                 "positive_state": true,
                                 "positive_voltage": 5.0,
                                 "positive_current": 0.1 }
   ← "Power supplies configured"
   ... (supply is now active) ...
3. discovery_supplies_close
4. discovery_device_close

Read a Sensor over I2C

Read 2 bytes from a sensor at address 0x48:

1. discovery_device_open → { "config": 0 }
2. discovery_i2c_open    → { "sda": 0, "scl": 1, "clock_rate": 100000 }
3. discovery_i2c_read    → { "count": 2, "address": 72 }
   ← { "data": "1A3F" }
4. discovery_i2c_close
5. discovery_device_close

Blink an LED with Static I/O

Toggle DIO line 0 as a digital output:

1. discovery_device_open      → { "config": 0 }
2. discovery_static_set_mode  → { "channel": 0, "output": true }
3. discovery_static_set_state → { "channel": 0, "value": true }
   ← "DIO 0 set HIGH"
4. discovery_static_set_state → { "channel": 0, "value": false }
   ← "DIO 0 set LOW"
5. discovery_static_close
6. discovery_device_close

UART Communication

Send and receive data at 115200 baud:

1. discovery_device_open → { "config": 0 }
2. discovery_uart_open   → { "rx": 1, "tx": 0, "baud_rate": 115200 }
3. discovery_uart_write  → { "data": "AT\r\n" }
   ← "Sent 4 bytes"
4. discovery_uart_read
   ← "OK\r\n"
5. discovery_uart_close
6. discovery_device_close

Project Structure

├── main.go              # CLI entry point and --check diagnostics
├── server/
│   ├── server.go        # MCP server setup and tool registration
│   ├── handlers.go      # MCP tool handler implementations
│   └── handlers_test.go # Unit tests with mock device
└── dwf/
    ├── interfaces.go    # Go interfaces (Oscilloscope, WavegenDriver, etc.)
    ├── types.go         # Configuration structs and enums
    ├── bindings.go      # CGo bindings to libdwf
    └── device.go        # Concrete device implementation

Testing

go test ./...

Tests use mock device implementations and do not require hardware.

License

MIT