Skip to main content
Glama

qudi MCP Integration

by dirkenglund
GitHub
Python
MIT License
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

๐Ÿ”ฌ qudi MCP Integration

Model Context Protocol (MCP) integration for qudi quantum photonics experiments

Enable natural language control of quantum experiments through Claude Desktop!

MIT License Python 3.8+ Claude Desktop

๐Ÿš€ Quick Start

1. Installation Options

๐Ÿ“‹ Standalone Mode (Recommended for Testing)

# Clone this repository git clone https://github.com/dirkenglund/qudi-mcp-integration.git cd qudi-mcp-integration # Install minimal dependencies (simulation only) pip install -r requirements-standalone.txt

๐Ÿ–ผ๏ธ With Plot Extraction Capabilities

# Install standalone + plot extraction pip install -r requirements-standalone.txt pip install -r requirements-plot-extraction.txt

๐Ÿ”ฌ Full qudi Integration (For Hardware Control)

# For real quantum hardware control pip install -r requirements-full.txt # Additional setup required: # 1. Install qudi-core separately # 2. Configure hardware drivers # 3. Set up measurement modules

2. Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "qudi-mcp": { "command": "/opt/homebrew/bin/python3", "args": ["/path/to/qudi-mcp-integration/simple_mcp_server.py"], "env": { "PYTHONPATH": "/path/to/qudi-mcp-integration", "QUDI_MCP_LOG_LEVEL": "INFO" } } } }

3. Test with Claude Desktop

Restart Claude Desktop and try:

"Get qudi station information"

Example Commands:

  • "Start a photoluminescence scan from 630-650 nm"

  • "Check all safety interlocks before measurement"

  • "Can I safely set laser power to 5 milliwatts?"

Features

๐Ÿ›ก๏ธ Safety First

  • Runlevels: dry-run โ†’ sim โ†’ live progression

  • Parameter Validation: All values checked against safety limits

  • Emergency Stop: Immediate halt capability

  • Interlocks: Critical system monitoring

๐Ÿ”ง Instrument Control

  • List and load qudi instruments

  • Get/set parameters with safety validation

  • Real-time status monitoring

  • Simulated operation for safe testing

๐Ÿ“Š Measurement Execution

  • Available modules: PL scan, gate sweep, resonance scan, time trace, 2D maps

  • Progress monitoring and data acquisition

  • Configurable measurement parameters

  • Data export capabilities

๐Ÿค– LLM Integration

  • Natural language command processing

  • Contextual tool suggestions

  • Comprehensive error reporting

  • Audit logging for all operations

๐Ÿ–ผ๏ธ Plot Extraction (Optional)

  • RKHS Spline Projection - Mathematical smoothing using reproducing kernel Hilbert spaces

  • Computer Vision - Extract data points from scientific plots and graphs

  • Spectrum Analysis - Advanced processing for spectroscopy data

  • Multiple Formats - Support for PNG, JPG, TIFF, and other image formats

  • Quantum Data - Optimized for photoluminescence and transport measurements

Plot Extraction Commands:

  • "Extract data from this plot image: /path/to/spectrum.png"

  • "Analyze spectrum with RKHS smoothing using epsilon 0.05"

  • "What plot extraction capabilities are available?"

Architecture

Claude โ†โ†’ MCP โ†โ†’ qudi_mcp_server โ†โ†’ qudi โ†โ†’ Instruments โ†“ Safety System Runlevel Control Parameter Validation

Core Components

  • qudi_mcp_server.py: Main MCP server and tool router

  • safety.py: Safety system and runlevel management

  • tools/: Tool implementations (instruments, measurements, safety)

  • claude_config/: Claude Desktop configuration templates

Safety System

Runlevels

  • dry-run (default): Simulation only, no hardware interaction

  • sim: Realistic simulation with hardware-like responses

  • live: Real hardware control (requires approval + safety checks)

Built-in Limits

  • Laser power: 0-10 mW

  • Gate voltages: ยฑ2.0 V

  • Bias voltages: ยฑ1.0 V

  • Temperature: 0.01-300 K

  • Magnetic field: ยฑ9.0 T

  • Measurement time: 0.001-3600 s

Emergency Procedures

All emergency stop triggers:

  • Halt all running measurements

  • Force runlevel to dry-run

  • Log incident with timestamp

  • Require manual reset with confirmation

Usage Examples

System Status

# Check system status โ†’ Get qudi station information # Response: runlevel, loaded instruments, active measurements, safety status

Instrument Control

# List instruments โ†’ List available qudi instruments # Load an instrument โ†’ Load the laser_controller instrument # Set parameter safely โ†’ Set laser power to 2.5 mW

Measurements

# Start a measurement โ†’ Start a photoluminescence scan from 630 to 650 nm with 0.5 second integration # Check progress โ†’ What's the status of running measurements? # Get results โ†’ Get the measurement data for the PL scan

Safety Operations

# Check safety systems โ†’ Check all safety interlocks # Change runlevel (when ready for hardware) โ†’ Set runlevel to sim mode for realistic testing # Emergency procedures โ†’ Emergency stop all operations

Development Status

โœ… Completed (Phase 1)

  • MCP server framework

  • Safety system with runlevels and limits

  • Tool architecture for instruments, measurements, safety

  • Claude Desktop integration

  • Comprehensive simulation mode

  • Documentation and setup guides

๐Ÿšง In Progress (Phase 2)

  • qudi core integration

  • Real instrument driver connections

  • Hardware abstraction layer

  • Live mode approval workflows

๐Ÿ“‹ Planned (Phase 3)

  • Advanced measurement protocols

  • Data analysis tool integration

  • Multi-user access control

  • Web-based monitoring interface

File Structure

mcp_integration/ โ”œโ”€โ”€ __init__.py # Package initialization โ”œโ”€โ”€ qudi_mcp_server.py # Main MCP server โ”œโ”€โ”€ safety.py # Safety and runlevel system โ”œโ”€โ”€ tools/ # MCP tool implementations โ”‚ โ”œโ”€โ”€ __init__.py โ”‚ โ”œโ”€โ”€ instrument_tools.py # Instrument control tools โ”‚ โ”œโ”€โ”€ measurement_tools.py # Measurement execution tools โ”‚ โ””โ”€โ”€ safety_tools.py # Safety and emergency tools โ”œโ”€โ”€ claude_config/ # Claude configuration templates โ”œโ”€โ”€ README.md # This file โ””โ”€โ”€ requirements.txt # Python dependencies

Development Guidelines

Adding New Tools

  1. Implement in appropriate tools/ module

  2. Register in qudi_mcp_server.py tool list

  3. Add safety validation for parameters

  4. Test thoroughly in dry-run mode

  5. Document in tool docstrings

Safety Requirements

  • All write operations must validate parameters

  • Critical operations need explicit approval in live mode

  • Comprehensive error handling and logging required

  • Emergency stop must work from any state

Testing Protocol

  1. Dry-run: Logic validation without hardware

  2. Simulation: Realistic behavior testing

  3. Hardware: Real instrument validation (when available)

  4. Safety: Verify all safety mechanisms

  5. Integration: End-to-end workflow testing

Troubleshooting

Common Issues

"MCP package not found"

pip install mcp

"Tool not found" errors

  • Check tool registration in qudi_mcp_server.py

  • Verify tool implementation in tools/ modules

Safety validation failures

  • Check parameter values against limits in safety.py

  • Use safety.get_limits to see current constraints

Claude Desktop not seeing tools

  • Verify absolute paths in configuration file

  • Restart Claude Desktop completely

  • Check Python path and MCP server execution

Getting Help

  1. Check logs: MCP server logs to stderr

  2. Test tools directly: Run python qudi_mcp_server.py

  3. Validate config: Check Claude Desktop config file syntax

  4. Start simple: Begin with station.info and safety.check_interlocks

Contributing

This integration is part of the MIT QPG development branch. To contribute:

  1. Fork the repository

  2. Create feature branches from dev/llm-mcp-automation

  3. Follow safety-first development practices

  4. Include comprehensive tests

  5. Update documentation for new features

Repository: https://github.com/dirkenglund/qudi-iqo-modules-QPG
Branch: dev/llm-mcp-automation
Documentation: See docs/LLM_MCP_INTEGRATION.md for full details

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables natural language control of quantum photonics experiments through the qudi framework. Supports safe instrument control, measurement execution, and safety system management with built-in runlevel protection and parameter validation.

  1. ๐Ÿš€ Quick Start
    1. 1. Installation Options
    2. 2. Configure Claude Desktop
    3. 3. Test with Claude Desktop
  2. Features
    1. ๐Ÿ›ก๏ธ Safety First
    2. ๐Ÿ”ง Instrument Control
    3. ๐Ÿ“Š Measurement Execution
    4. ๐Ÿค– LLM Integration
    5. ๐Ÿ–ผ๏ธ Plot Extraction (Optional)
  3. Architecture
    1. Core Components
  4. Safety System
    1. Runlevels
    2. Built-in Limits
    3. Emergency Procedures
  5. Usage Examples
    1. System Status
    2. Instrument Control
    3. Measurements
    4. Safety Operations
  6. Development Status
    1. โœ… Completed (Phase 1)
    2. ๐Ÿšง In Progress (Phase 2)
    3. ๐Ÿ“‹ Planned (Phase 3)
  7. File Structure
    1. Development Guidelines
      1. Adding New Tools
      2. Safety Requirements
      3. Testing Protocol
    2. Troubleshooting
      1. Common Issues
      2. Getting Help
    3. Contributing

      New MCP Servers

      MCP directory API

      We provide all the information about MCP servers via our MCP API.

      curl -X GET 'https://glama.ai/api/mcp/v1/servers/dirkenglund/qudi-mcp-integration'

      If you have feedback or need assistance with the MCP directory API, please join our Discord server