Prerequisites

• Python 3.12
• OpenAI API Key (Get one here)
• Windows PowerShell or Git Bash (for commands below)

Quick Start

1. Navigate to Project root folder.
2. Open "cmd" / "terminal"
3. Create virtual enviornment: python -m venv venv
4. Activate virtual enviornment: venv\Scripts\activate
5. Install dependencies: pip install -r requirements.txt
6. Setup enviornment variables: cp .env.example .env
7. Run program: python main.py

Project Structure

log-explainer-mcp-server/
├── .env.example
├── README.md
├── servers/
│   ├── string_processor.py
│   ├── file_processsor.py
├── main.py
├── requirements.txt

• servers/ – core mcp-server modules; each implements a different type of MCP Server.
• string_processor.py - log explainer for simple 1-2 line strings of error.
• file_processor.py - log explainer for simple entire log-files error. Search errors -> invoke MCP -> suggest root-cause -> with other details (WIP).
• main.py – entry point orchestrating the agents.
• .env.example – environment variable template.
• requirements.txt – Python dependencies.

Working example

License

MIT License © 2026-PRESENT Parth Kansara