MiSAR – Microservice Architecture Recovery Toolset

MiSAR is a research-driven toolset designed to semi-automatically recover architectural models from implemented microservice-based systems using a Model-Driven Architecture (MDA) approach.

Overview

MiSAR transforms implementation artefacts into architectural models through the following pipeline:

Code → PSM → PIM → UML

• PSM (Platform Specific Model) → extracted from source code and configuration
• PIM (Platform Independent Model) → abstract representation of the architecture
• UML / Visualisation → optional diagrams and summaries

A full demonstration is available here:
👉 https://www.youtube.com/watch?v=sdRDkLesyS0

Supported Technologies/Frameworks

• Java (Spring Boot / Spring Cloud)
• Docker / docker-compose
• Python (Flask / FastAPI / Django)

Core Components

1. MiSAR Parser

• Analyses microservice-based systems
• Supports:
  • Java (Spring Boot / Spring Cloud)
  • Docker / docker-compose
  • XML / YAML (e.g. pom.xml)

👉 Output: PSM (.xmi)

2. Transformation Engine (QVT)

• Converts PSM → PIM
• Uses QVT Operational (QVTo) inside Eclipse

👉 Output: PIM (.xmi)

3. Graphical Model Generator

• Generates:
  • UML diagrams
  • Excel summaries
  • dependency views

👉 Final architecture visualisation

📚 Documentation

Full Documentation

Installation instructions

Recent Improvements

🧪 Example Systems

MiSAR has been evaluated on:

• MicroCompany

• TrainTicket

• MusicStore

👉 Full history: docs/changelog.md

⚠️ Notes

• Parser is currently focused on Java-based microservices
• QVT setup requires Eclipse Modeling Tools
• MISAR only requires internet access during the initial setup to download necessary dependencies. Once set up, it can be used offline without any issues.

🤝 Contributing

Contributions are welcome:

1. Create a feature branch

2. Submit a pull request

3. Provide clear reproduction steps

👨‍💻 Authors

© 2020-2026 Dr Nour Ali, Brunel University London. All rights reserved. MiSAR is made openly available for research and evaluation purposes. The intellectual property and copyright of this tool and its associated research remain with Dr Nour Ali and Brunel University London. If you use MiSAR in your work, please cite the relevant publications.

• Contributors – Nuha Alshuqayran and students

🔗 Links

• Main Repository: https://github.com/MicroServiceArchitectureRecovery/misar
• Parser & Transformation: https://github.com/MicroServiceArchitectureRecovery/MiSAR-Parser-and-Model-Transformation