Skip to main content

MoziChem-MCP tools built on top of the MoziChem framework

Project description

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

MoziChem-MCP

MoziChem-MCP Logo

MoziChem-MCP MCP server

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.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mozichem_mcp_fastmcp-0.1.1.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mozichem_mcp_fastmcp-0.1.1-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

Details for the file mozichem_mcp_fastmcp-0.1.1.tar.gz.

File metadata

File hashes

Hashes for mozichem_mcp_fastmcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 92b9ec85630ee4e9fb709d686bdb331cd2ea93b8e4d2f26514bc6b45e5d8cc9f
MD5 cb82e4270a45b20ca1af9ce321ac18be
BLAKE2b-256 8c350e1855e7d1809b11383a1c98ac85ec0d8358fd4bf535c9d8041def2b3344

See more details on using hashes here.

File details

Details for the file mozichem_mcp_fastmcp-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for mozichem_mcp_fastmcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 740ef2ec7d15a467f4e50052ec06ed57ae4ea80408fddfc44618f86df700c0e0
MD5 8d695dc0d1e3bd82473c233841c82fc2
BLAKE2b-256 5a7d357d2a68a66a106febe486ae0a1d1678c411f7b2d9f16a349423f5959296

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page