Skip to main content
Glama

Add to Cursor Add to VS Code Add to Claude Add to ChatGPT Add to Codex Add to Gemini

MoziChem-MCP

MoziChem-MCP Logo

PyPI Downloads PyPI Version Supported Python Versions License MCP

A collection of Model Context Protocol (MCP) servers for chemical engineering and chemistry applications, built on top of the powerful MoziChem framework. This repository provides specialized MCP tools that enable AI assistants to perform complex chemical calculations, thermodynamic modeling, and process engineering tasks.

🧪 Overview

MoziChem-MCP bridges the gap between AI language models and chemical engineering calculations by providing structured access to thermodynamic models, equation of state calculations, phase equilibrium computations, and other essential chemical engineering tools through the Model Context Protocol.

Important Notes: This repository is actively maintained and will be updated with new MCP servers and features in the future. Stay tuned for additions to support more chemical engineering domains.

Related MCP server: FLASK-tools

🚀 Features

Current MCP Servers

  • 🌡️ EOS Models MCP (eos-models-mcp)

    • Equation of State calculations using various models (Peng-Robinson, Soave-Redlich-Kwong, Redlich-Kwong, van der Waals)

    • Fugacity calculations for pure components and mixtures

    • Thermodynamic property predictions

    • Phase behavior analysis

  • ⚖️ Flash Calculations MCP (flash-calculations-mcp)

    • Vapor-liquid equilibrium calculations

    • Multi-component phase equilibrium

    • Temperature and pressure flash calculations

    • Bubble point and dew point calculations

📦 Installation

Prerequisites

  • Python 3.13 or higher

  • uv package manager (recommended)

Install from Source

# Clone the repository
git clone https://github.com/sinagilassi/mozichem-mcp.git
cd mozichem-mcp

# Install using uv (recommended)
uv sync

# Or install using pip
pip install -e .

Install from PyPI (when available)

pip install mozichem-mcp

🔧 Usage

Running MCP Servers

Each MCP server can be run independently:

EOS Models MCP Server

# Using uvx with the published package
uvx --from mozichem-mcp mozichem-mcp-eos-models

# Or run directly with Python (if installed locally)
python -m mozichem_mcp.mcp.eos_models

Flash Calculations MCP Server

# Using uvx with the published package
uvx --from mozichem-mcp mozichem-mcp-flash-calculation

# Or run directly with Python (if installed locally)
python -m mozichem_mcp.mcp.flash_calculation

Integration with AI Assistants

These MCP servers are designed to work with AI assistants that support the Model Context Protocol, such as:

  • Claude Desktop

  • Other MCP-compatible AI tools

Example Configuration for Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "mozichem-eos": {
      "command": "uvx",
      "args": ["--from", "mozichem-mcp", "mozichem-mcp-eos-models"]
    },
    "mozichem-flash": {
      "command": "uvx",
      "args": ["--from", "mozichem-mcp", "mozichem-mcp-flash-calculation"]
    }
  }
}

Example Calculations

Once integrated with an AI assistant, you can perform calculations like:

"Calculate the fugacity of methane at 300K and 10 bar using the Peng-Robinson equation of state"

"Perform a flash calculation for a mixture of 40% methane and 60% ethane at 250K and 20 bar"

📚 Documentation

Chemical Engineering Applications

  • Process Design: Use for preliminary process calculations and design

  • Research: Integrate with computational workflows for chemical engineering research

  • Education: Enhance learning with interactive thermodynamic calculations

  • Industry: Support engineering decisions with reliable thermodynamic data

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request to improve the project.

📝 License

This project is licensed under the MIT License. You are free to use, modify, and distribute this software in your own applications or projects. However, if you choose to use this app in another app or software, please ensure that my name, Sina Gilassi, remains credited as the original author. This includes retaining any references to the original repository or documentation where applicable. By doing so, you help acknowledge the effort and time invested in creating this project.

❓ FAQ

For any questions, contact me on LinkedIn.

👨‍💻 Authors


⭐ Star this repository if you find it useful for your chemical engineering projects!

🐛 Report issues or 💡 suggest new features in the Issues section.

Available Tools

5 tools
calc_bubble_pressure_ideal_vapor_ideal_liquidA

The Bubble-Pressure (BP) calculation determines the pressure at which the first bubble of vapor forms when a liquid mixture is heated at a constant temperature. It is used to find the pressure for a given temperature at which the liquid will begin to vaporize.

Inputs: components (required), temperature (required). Returns: result

calc_bubble_temperature_ideal_vapor_ideal_liquidB

The Bubble-Temperature (BT) calculation determines the temperature at which the first bubble of vapor forms when a liquid mixture is heated at a constant pressure. It is used to find the temperature for a given pressure at which the liquid will begin to vaporize.

Inputs: pressure (required), components (required), solver_method. Returns: result

calc_dew_pressure_ideal_vapor_ideal_liquidA

The Dew-Pressure (DP) calculation determines the pressure at which the first drop of liquid condenses from a vapor mixture when cooled at a constant temperature. It is used to find the pressure for a given temperature at which the vapor will begin to condense.

Inputs: components (required), temperature (required). Returns: result

calc_dew_temperature_ideal_vapor_ideal_liquidB

The Dew-Temperature (DT) calculation determines the temperature at which the first drop of liquid condenses from a vapor mixture when cooled at a constant pressure. It is used to find the temperature for a given pressure at which the vapor will begin to condense.

Inputs: pressure (required), components (required), solver_method. Returns: result

calc_flash_isothermal_ideal_vapor_ideal_liquidB

The Flash Isothermal (FI) calculation determines the phase equilibrium of a liquid mixture at a constant temperature, calculating the vapor and liquid phase compositions. It is used to find the equilibrium state of a mixture at a specified temperature.

Inputs: pressure (required), components (required), temperature (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool corresponds to a distinct, well-defined VLE calculation: bubble pressure, dew pressure, bubble temperature, dew temperature, and isothermal flash. The descriptions clearly differentiate the independent variable and physical phenomenon, so there is no meaningful ambiguity between tools.

    Naming Consistency5/5

    All tool names follow the exact same pattern: calc_<calculation_type>_ideal_vapor_ideal_liquid. This creates a highly predictable and systematic naming convention, despite the names being long.

    Tool Count5/5

    Five tools is an appropriate, focused count for a specialized vapor-liquid equilibrium server. Each tool covers a core calculation type without redundant or unnecessary helpers.

    Completeness5/5

    The tool set covers the standard set of ideal VLE calculations: bubble point (pressure and temperature), dew point (pressure and temperature), and isothermal flash. Within the stated ideal vapor/ideal liquid scope, there are no obvious missing operations or dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to perform complex chemical engineering calculations including thermodynamic modeling, equation of state calculations, phase equilibrium computations, and vapor-liquid equilibrium analysis. Built on the MoziChem framework to bridge AI language models with specialized chemical engineering tools.
      6
      15 PyPI
      4
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Provides a collection of MCP servers for computational chemistry tasks including molecular generation and retrosynthesis. Also offers property prediction and molecule pricing capabilities.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for chemistry-focused tools, enabling LLM agents to perform molecule parsing, format conversion, property lookup, and other chemistry operations with explainable responses.
      Apache 2.0