Provides tools for electromagnetic simulation using Octave/OpenEMS, including creating CPW simulations, running full-wave analysis, extracting S-parameters, analyzing impedance, and exporting results in various formats.
Enables quantum circuit design using Qiskit Metal, with tools for creating designs, configuring CPW parameters, adding transmon qubits and couplers, routing transmission lines, exporting to GDS format, and visualizing with KLayout.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Funky Junction design a transmon qubit with 50Ī© CPW lines and simulate its impedance"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A comprehensive MCP server ecosystem for quantum circuit design using Qiskit Metal and electromagnetic simulation via Octave/OpenEMS.
Built by Team Silicon Architects at the Stanford MCP x Quantum Science Hackathon 2025
Team Members: Sarah Dweik, Sebastien Boussard, Paul Goldschmidt, & Gabriel Dupuis
Related MCP server: qiskit-sim-mcp
š§ Quantum Circuit Design: Complete design workflow with Qiskit Metal
ā” EM Simulation: Full-wave electromagnetic analysis using Octave/OpenEMS
š Optimization Loops: Automated parameter optimization with convergence detection
š Learning Resources: Python examples and research paper access
š¤ Dual MCP Architecture: 25+ specialized tools across two integrated servers
Python 3.8+, Octave 4.0+, OpenEMS, Git
# Clone repository
git clone https://github.com/PaulGoldschmidt/qsim-mcp.git
cd qsim-mcp
# Install Python dependencies
pip install -r requirements.txt
# Install system dependencies (Ubuntu/Debian)
sudo apt update && sudo apt install octave openems
# Verify installation
python -c "import qiskit_metal; print('ā Qiskit Metal ready')"
octave --version && openEMS --versionStart Both MCP Servers:
# Terminal 1 - Qiskit Metal Server
cd src/qiskit-metal-mcp && python quantum_hardware_mcp_server.py
# Terminal 2 - Octave OpenEMS Server
cd src/octave-mcp && python octave_openems_server.pyBasic Optimization Workflow:
# 1. Design Phase
create_design()
set_design_variables(cpw_width='10um', cpw_gap='6um')
create_transmons(q1_pos_x='-2.5mm', q2_pos_x='2.5mm')
export_design_to_gds('./quantum_design.gds')
# 2. Simulation Phase
create_cpw_octave_simulation(name='opt_v1', width=10.0, gap=6.0)
run_octave_simulation('opt_v1')
# 3. Analysis & Iteration
analyze_octave_impedance('opt_v1')
# Adjust parameters if needed and repeat
# 4. Export Results
export_octave_results('opt_v1', export_format='touchstone')qsim-mcp/
āāā src/
ā āāā qiskit-metal-mcp/ # Quantum circuit design server
ā ā āāā quantum_hardware_mcp_server.py
ā ā āāā requirements.txt
ā āāā octave-mcp/ # EM simulation server
ā ā āāā octave_openems_server.py
ā ā āāā requirements.txt
ā āāā resources/ # Examples and papers
āāā requirements.txt # Combined dependencies
āāā README.mdcreate_design() - Initialize quantum circuit design
set_design_variables() - Configure CPW parameters (cpw_width, cpw_gap)
create_transmons() - Add transmon qubits with positioning
add_coupler() - Create spiral inductors (n_turns, spacing)
connect_components() - Route CPW transmission lines
export_design_to_gds() - Export for fabrication
visualize_gds_with_klayout() - Professional visualization
create_cpw_octave_simulation() - Set up EM simulation
run_octave_simulation() - Execute full-wave analysis
extract_octave_s_parameters() - Analyze S11, S21 parameters
analyze_octave_impedance() - Verify 50Ī© characteristic impedance
export_octave_results() - Export to Touchstone, CSV, JSON
list_octave_simulations() - View completed simulations
Set Targets: Define optimization goals (impedance, Q-factor, coupling)
Design: Create/modify quantum circuit components in Qiskit Metal
Simulate: Run electromagnetic analysis with synchronized parameters
Analyze: Compare results against targets
Iterate: Adjust parameters until convergence
Export: Generate GDS files and simulation reports
MCP Client Setup:
{
"mcpServers": {
"qiskit-metal": {
"command": "python3",
"args": ["src/qiskit-metal-mcp/quantum_hardware_mcp_server.py"]
},
"octave-openems": {
"command": "python3",
"args": ["src/octave-mcp/octave_openems_server.py"]
}
}
}System Requirements Issues:
# Install missing dependencies
sudo apt install octave openems # Ubuntu/Debian
brew install octave # macOS
# Check installations
check_octave_openems_status()
check_status()Common Solutions:
Simulation timeout: Increase timeout in config.json
Memory issues: Use clear_octave_data("all")
Permission errors: Check file paths and write permissions
# Target: 50Ī© Ā±5% characteristic impedance
targets = {'impedance': 50.0, 'tolerance': 2.5}
for iteration in range(1, 6):
# Design with current parameters
set_design_variables(cpw_width=f'{current_width}um', cpw_gap=f'{current_gap}um')
# Simulate
create_cpw_octave_simulation(name=f'iter_{iteration}',
width=current_width, gap=current_gap)
run_octave_simulation(f'iter_{iteration}')
# Analyze and check convergence
results = analyze_octave_impedance(f'iter_{iteration}')
if within_tolerance(results, targets):
print(f"ā
Converged in {iteration} iterations!")
break
# Adjust parameters for next iteration
current_width, current_gap = optimize_parameters(results, targets)
# Export final design
export_design_to_gds('./optimized_quantum_chip.gds')
export_octave_results(f'iter_{iteration}', 'touchstone')MIT License - see LICENSE file for details.
Contributions welcome! Create an issue or submit a pull request.
Built with ā¤ļø by Team Silicon Architects for the quantum computing community
This server cannot be deployed
QuLab MCP remote server (Streamable HTTP) for computational science and lab tools.
Research-only MCP server: your AI as a quant research desk. 90 tools, no trades, no brokers.
Production-grade cryptography toolkit with 31 MCP tools for classical, PQC, and KMS workflows.
Self-hosted MCP server: 26 deterministic dev, security, and EVM tools.
