Skip to main content

MoziChem-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.

🚀 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 the installed command
mozichem-mcp-eos-models

# Or run directly with Python
python -m mozichem_mcp.mcp.eos_models

Flash Calculations MCP Server

# Using the installed command
mozichem-mcp-flash-calculation

# Or run directly with Python
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": ["mozichem-mcp-eos-models"]
    },
    "mozichem-flash": {
      "command": "uvx",
      "args": ["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.

Metadata

Release files for mozichem-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mozichem-mcp 0.1.0
File Size Uploaded
mozichem_mcp-0.1.0.tar.gz 4.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mozichem-mcp 0.1.0
File Interpreter ABI Platform
mozichem_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 9.9 kB

Release files / mozichem_mcp-0.1.0.tar.gz

Download URL mozichem_mcp-0.1.0.tar.gz
Size 4.5 kB
Tags Source
SHA-256 checksum
How to use checksums
cba3672252d98042c707ac3bb767ba12497990a3637136546cf7d65792fda898
BLAKE2b-256 checksum
How to use checksums
ed0591abb4be2a82fb3689ca9db2300be48a63e9c011aaf6d13fd8501ccd6968
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.3

Release files / mozichem_mcp-0.1.0-py3-none-any.whl

Download URL mozichem_mcp-0.1.0-py3-none-any.whl
Size 5.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c43380e156096178f37bcc4756800c7b206616c0e0c270da0930b4844ca0e233
BLAKE2b-256 checksum
How to use checksums
02d7510cac4cec5c8b8cb0b70987a1f2f08d3f8c5839df9fa12ba9dc45935757
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.8.3

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page