Skip to main content

MCP server for wave mechanics and Schrodinger equation simulations

Project description

scicomp-quantum-mcp

mcp-name: io.github.andylbrummer/quantum-mcp

MCP server for wave mechanics and Schrödinger equation simulations.

Overview

This server provides tools for quantum mechanics simulations and wavefunction analysis:

  • Schrödinger solver - Time-dependent wave equation simulations in 1D and 2D
  • Potential creation - Crystalline lattices, custom potentials, harmonic oscillators
  • Wavefunction analysis - Observable computation, probability density, energy analysis
  • Wave packets - Gaussian wave packet creation and evolution
  • GPU acceleration - Optional CUDA acceleration for large simulations

Installation & Usage

# Run directly with uvx (no installation required)
uvx scicomp-quantum-mcp

# Or install with pip
pip install scicomp-quantum-mcp

# With GPU support
pip install scicomp-quantum-mcp[gpu]

# Run as command
scicomp-quantum-mcp

Available Tools

Potential Creation

  • create_lattice_potential - Crystalline lattice potentials (square, hexagonal, triangular)
  • create_custom_potential - Custom potential from mathematical function
  • create_gaussian_wavepacket - Localized Gaussian wave packets
  • create_plane_wave - Plane wave states

Simulation

  • solve_schrodinger - 1D time-dependent Schrödinger equation
  • solve_schrodinger_2d - 2D time-dependent Schrödinger equation
  • get_task_status - Monitor async simulations
  • get_simulation_result - Retrieve completed simulation data

Analysis

  • analyze_wavefunction - Compute observables from wavefunction
  • visualize_potential - Plot potential energy landscapes
  • render_video - Animate probability density evolution

Configuration

Enable GPU acceleration with environment variable:

MCP_USE_GPU=1 scicomp-quantum-mcp

Examples

🎬 Visual Demos

Spectacular animated demonstrations:

Run demos with Claude:

claude -p "Simulate double-slit interference" \
  --allowedTools "mcp__quantum-mcp__*"

📖 Code Examples

Practical tutorials in EXAMPLES.md:

  • Particle in a box dynamics
  • Double-slit interference patterns
  • Quantum tunneling
  • Crystal lattice scattering

📚 Full Documentation

See the API documentation for complete reference.

Part of Math-Physics-ML MCP System

Part of a comprehensive system for scientific computing. See the documentation for the complete ecosystem.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scicomp_quantum_mcp-0.1.4.tar.gz (13.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scicomp_quantum_mcp-0.1.4-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file scicomp_quantum_mcp-0.1.4.tar.gz.

File metadata

  • Download URL: scicomp_quantum_mcp-0.1.4.tar.gz
  • Upload date:
  • Size: 13.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for scicomp_quantum_mcp-0.1.4.tar.gz
Algorithm Hash digest
SHA256 4f1018221059290cedf7901fa597bec2efe9cbeb85e8e9e9c5391fb7500cd202
MD5 c52d4cb2807ff0a9498c5cf4f2cb22a1
BLAKE2b-256 3746c1ed5d8241831907456c00089d456d571a6e6356b1504e7fe611d9462b31

See more details on using hashes here.

Provenance

The following attestation bundles were made for scicomp_quantum_mcp-0.1.4.tar.gz:

Publisher: publish.yml on andylbrummer/math-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scicomp_quantum_mcp-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for scicomp_quantum_mcp-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 07c33ac308ef00ae513ebb780c1d036f0b054eb707c87c501ab1c5d34caab755
MD5 12d21e1d0309ab4113f6bcf42fb60141
BLAKE2b-256 00d696f1b245a8963c69a6855c913711d2b883d118d6f89e2152573242225f6e

See more details on using hashes here.

Provenance

The following attestation bundles were made for scicomp_quantum_mcp-0.1.4-py3-none-any.whl:

Publisher: publish.yml on andylbrummer/math-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page