Rabi

You can run the Rabi MCP Server to simulate AMO physics phenomena through five core tools. It provides practical quantum system simulations that you can access from your preferred MCP client or integration, enabling real-time analysis, plotting, and experimentation with two-level atoms, Rabi oscillations, Bose-Einstein condensates, absorption spectra, and cavity QED dynamics.

How to use

Connect to the server from your MCP client and load the five core AMO physics tools. You can run simulations, adjust parameters in real time, and retrieve results for visualization or further processing in your AI assistant workflows. Use the health endpoint to verify the server is reachable, and then invoke individual tools by passing the required inputs described in each tool’s usage notes.

How to install

Prerequisites you need before installing:

• Python 3.8 or newer
• Docker (optional, for the Docker-based setup)
• Git (for cloning the repository)
• A terminal or shell with access to your system path Follow the installation paths below to run the server locally or in a container.

# Manual Installation (local development and testing)
# Clone repository
git clone https://github.com/manasp21/rabi-mcp.git
cd rabi-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install --upgrade pip
pip install -r requirements.txt

# Test the server
python run_simple_server.py

# Optional: test health endpoint
# curl http://localhost:8000/health

# Docker (build and run)
# Clone and build
git clone https://github.com/manasp21/rabi-mcp.git
cd rabi-mcp

docker build -t rabi-mcp-server .
docker run -p 8000:8000 rabi-mcp-server

Additional notes

If you prefer cloud deployment, you can use supported deployment methods that provision the server with the same five core tools and integration points. After starting, the server exposes an HTTP interface on port 8000 by default, and you can adjust the port using environment configuration if needed.

Available tools

simulate_two_level_atom

Simulates quantum dynamics of a two-level atomic system with controllable Rabi frequency and detuning to analyze real-time population dynamics and coherence.

rabi_oscillations

Analyzes coherent oscillations between energy levels, including on-resonance and off-resonance behavior with time-resolved population transfer.

bec_simulation

Models basic Bose-Einstein condensate dynamics using simplified Gross-Pitaevskii framework with interactions and quantum statistics.

absorption_spectrum

Calculates spectral lines including natural and Doppler broadening with temperature-dependent linewidths and both Lorentzian and Gaussian profiles.

cavity_qed

Simulates atom-photon coupling in a cavity using the Jaynes-Cummings model to explore strong and weak coupling regimes.