File size: 4,571 Bytes
9a406c7 eb20770 9a406c7 eb20770 9a406c7 eb20770 9a406c7 eb20770 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 |
---
title: Quantum ESPRESSO MCP Server
emoji: ⚛️
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: "5.8.0"
app_file: app.py
pinned: false
license: mit
tags:
- mcp
- quantum-espresso
- dft
- materials-science
- building-mcp-track-enterprise
- building-mcp-track-consumer
---
# ⚛️ Quantum ESPRESSO MCP Server
> **Run DFT calculations with natural language!** An MCP server that enables LLMs to perform first-principles quantum mechanical simulations.
[](https://modelcontextprotocol.io)
[](https://www.quantum-espresso.org/)
[](https://opensource.org/licenses/MIT)
## 🎯 What This Does
This MCP server allows AI agents (Claude, GPT, etc.) to:
- **Calculate total energies** of materials (Si, Fe, Cu, GaAs...)
- **Compute band structures** and find band gaps
- **Run density of states** calculations
- **Optimize crystal structures** (relax atoms and cells)
- **Handle magnetic materials** automatically (Fe, Co, Ni...)
**Just say:** *"Calculate the band structure of silicon"* - and the AI does the rest!
## 🎥 Demo Video
[📹 Watch Demo on YouTube](YOUR_YOUTUBE_LINK_HERE)
## 📱 Social Media
[🐦 X/Twitter Post](YOUR_TWITTER_LINK_HERE)
## 🔧 12 MCP Tools Available
| Tool | Description |
|------|-------------|
| `qe_run_scf` | Self-consistent field calculation (total energy) |
| `qe_run_relax` | Optimize atomic positions |
| `qe_run_vc_relax` | Variable-cell relaxation |
| `qe_workflow_bandstructure` | Complete band structure workflow |
| `qe_workflow_dos` | Density of states calculation |
| `qe_workflow_relax_and_scf` | Relax then accurate SCF |
| `qe_load_structure` | Load/inspect structures |
| `qe_get_kpath` | Get k-path for band structure |
| `qe_suggest_kpoints` | Auto-suggest k-point grid |
| `qe_list_pseudopotentials` | List 69 available elements |
| `qe_validate_structure` | Check structure for issues |
| `qe_status` | Server status |
## ✨ Key Features
### 🧠 Smart Auto-Detection
- **Only `structure` is required** - everything else is auto-detected!
- K-points automatically chosen based on cell size
- Cutoffs from SG15 pseudopotentials
- Spin polarization auto-enabled for Fe, Co, Ni, Mn, Cr, V
### 📚 69 Elements Supported
Full periodic table coverage with SG15 ONCV pseudopotentials:
> Ag, Al, Ar, As, Au, B, Ba, Be, Bi, Br, C, Ca, Cd, Cl, Co, Cr, Cs, Cu, F, Fe, Ga, Ge, H, He, Hf, Hg, I, In, Ir, K, Kr, La, Li, Mg, Mn, Mo, N, Na, Nb, Ne, Ni, O, Os, P, Pb, Pd, Pt, Rb, Re, Rh, Ru, S, Sb, Sc, Se, Si, Sn, Sr, Ta, Tc, Te, Ti, Tl, V, W, Xe, Y, Zn, Zr
### 🎯 8 Prompts for Guided Workflows
- `band_structure` - Band structure calculation guide
- `dos_calculation` - DOS workflow
- `geometry_optimization` - Structure relaxation
- `convergence_test` - Parameter testing
- `surface_calculation` - Surface energy
- `magnetic_calculation` - Magnetic properties
- `troubleshoot` - Diagnose problems
- `compare_structures` - Compare materials
## 🚀 Quick Start
### Use with Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"quantum-espresso": {
"command": "uv",
"args": ["--directory", "/path/to/QE_MCP", "run", "qe-mcp"]
}
}
}
```
Then ask Claude:
- *"Calculate the total energy of silicon"*
- *"What's the band gap of GaAs?"*
- *"Run a spin-polarized calculation for iron"*
## 📊 Example Results
### Silicon SCF
```
Total Energy: -214.49 eV
Fermi Energy: 6.30 eV
Converged: 4 iterations
```
### Iron (Magnetic)
```
Total Energy: -3220.53 eV
Magnetization: 7.63 μB
Spin-polarized: Auto-enabled
```
### GaAs Band Structure
```
Band Gap: 0.56 eV (indirect)
VBM → CBM: Γ → X
```
## 🏗️ Architecture
```
User (natural language)
↓
LLM (Claude/GPT)
↓
MCP Protocol
↓
QE-MCP Server (Python)
↓
Docker Container (Quantum ESPRESSO v6.7)
↓
DFT Calculation Results
↓
Structured Output (JSON)
```
## 🛠️ Tech Stack
- **Quantum ESPRESSO v6.7MaX** - DFT engine
- **MCP SDK** (mcp>=1.0.0) - Model Context Protocol
- **ASE 3.26** - Atomic Simulation Environment
- **Docker** - Containerized QE
- **SG15 ONCV** - Pseudopotentials (69 elements)
## 👤 Team
- **Joseph Frimpong** - [@frimpsjoe](https://huggingface.co/frimpsjoe)
## 📜 License
MIT License
---
*Built for [MCP's 1st Birthday Hackathon](https://huggingface.co/MCP-1st-Birthday) 🎂*
|