Skip to main content
Glama

MCP LAMMPS Server

by Chenghao-Wu

MCP LAMMPS Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with LAMMPS (Large-scale Atomic/Molecular Massively Parallel Simulator) for molecular dynamics simulations.

Status

This is still in experimental status. This package is developed in collaboration with AI coder.

Overview

This MCP is part of our workflow for the autonomous computational materials design with LLM. This MCP server provides a standardized interface for controlling LAMMPS molecular dynamics simulations through natural language commands. It enables AI assistants to:

  • Set up and configure molecular dynamics simulations
  • Run equilibration and production simulations
  • Monitor simulation progress in real-time
  • Analyze simulation results
  • Manage simulation workflows

Features

Core Capabilities

  • Simulation Management: Create, configure, and run LAMMPS simulations
  • Structure Handling: Load molecular structures from various formats
  • Real-time Monitoring: Track simulation progress and system properties
  • Analysis Tools: Process trajectories and calculate thermodynamic properties
  • Workflow Automation: Define and execute multi-step simulation workflows

Installation

Prerequisites

  • Python 3.9 or higher
  • LAMMPS with Python interface

Quick Start

  1. Clone the repository:
    git clone https://github.com/mcp-lammps/mcp-lammps.git cd mcp-lammps
  2. Create a virtual environment:
    python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
  3. Install dependencies:
    pip install -r requirements.txt
  4. Install in development mode:
    pip install -e .

Usage

Basic Usage

Start the MCP server:

python -m mcp_lammps.server

Configuration

The server can be configured through environment variables or configuration files:

export MCP_LAMMPS_LOG_LEVEL=INFO export MCP_LAMMPS_WORK_DIR=/path/to/workspace python -m mcp_lammps.server

Example Prompt

``create a water simulation with 10 water molecules, save the relevant files, run the simulation at 300 K under NVT ensemble in the selected folder (examples)''

Development

Project Structure

mcp_lammps/ ├── src/mcp_lammps/ │ ├── server.py # Main MCP server │ ├── lammps_interface.py # LAMMPS wrapper │ ├── simulation_manager.py # Simulation management │ ├── data_handler.py # Data processing │ ├── tools/ # MCP tools │ └── utils/ # Utilities ├── tests/ # Test suite ├── examples/ # Usage examples └── docs/ # Documentation

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Ensure all tests pass
  6. Submit a pull request

License

This project is licensed under the Apache License - see the LICENSE file for details.

Acknowledgments

  • LAMMPS development team for the molecular dynamics engine
  • Model Context Protocol community for the MCP framework
  • Scientific computing community for inspiration and feedback
  • LLM for writing the code
-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A Model Context Protocol server that enables AI assistants to interact with LAMMPS for molecular dynamics simulations through natural language commands.

  1. Status
    1. Overview
      1. Features
        1. Core Capabilities
      2. Installation
        1. Prerequisites
        2. Quick Start
      3. Usage
        1. Basic Usage
        2. Configuration
        3. Example Prompt
      4. Development
        1. Project Structure
      5. Contributing
        1. License
          1. Acknowledgments

            Related MCP Servers

            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.
              Last updated -
              71
              3
              TypeScript
            • -
              security
              F
              license
              -
              quality
              A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
              Last updated -
              6
              1
              TypeScript
            • -
              security
              A
              license
              -
              quality
              A high-performance Model Context Protocol (MCP) server designed for large language models, enabling real-time communication between AI models and applications with support for session management and intelligent tool registration.
              Last updated -
              2
              Python
              MIT License
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that enables AI assistants to communicate with each other using Inter-Process Communication, featuring natural language commands and cross-platform compatibility.
              Last updated -
              9
              78
              Python
              MIT License

            View all related 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/Chenghao-Wu/MCP_LAMMPS'

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