🚀 EduPilot: Next-Gen AI Tutor Ecosystem

A Production-Ready, Multi-Agent Orchestration Engine built on the Model Context Protocol (MCP)

Delivering hyper-personalized, adaptive, and interactive learning experiences at scale.

🌎 The Vision

Traditional education scales poorly. Static curricula fail to adapt, and single-prompt LLMs lack the memory, pedagogical structure, and safety required for true learning.

EduPilot solves this by leveraging a decentralized Multi-Agent architecture. Instead of relying on a single omniscient LLM, we use LangGraph to act as a routing supervisor state-machine. It dynamically intercepts natural language intents and routes tasks to highly specialized, goal-oriented CrewAI expert agents. The result? A fully autonomous digital tutor that maintains permanent state, consults real textbooks via Vector RAG, and serves everything seamlessly over the newly minted Model Context Protocol (MCP).

Related MCP server: tutor-mcp-python

⚡ The Tech Stack

We don't do monolithic architectures here. This is a modular, event-driven orchestration stack:

• Orchestration Layer: LangGraph (Supervisor State Machine)

• Agent Intelligence: CrewAI & LangChain (Lesson Planner, Doubt Resolver, Quiz Generator)

• Knowledge Retrieval & RAG: ChromaDB (Local Embeddings for ultra-low latency contextual retrieval)

• State & Memory Persistence: SQLite (Native Offline Storage for longitudinal mastery mapping)

• API & Extensibility: FastAPI (REST endpoints) + FastMCP (Claude Desktop Integration)

• Frontend App: Zero-dependency Vanilla HTML/CSS/JS (Glassmorphism Dark Mode)

🧠 The Agent Force

📦 Quick Start Installation

Get up and running in your local dev environment in under 60 seconds.

1. Clone & Set up the Virtual Environment

python -m venv venv
source venv/bin/activate  # On Windows: .\venv\Scripts\Activate.ps1

2. Hydrate Dependencies

pip install -r requirements.txt

3. Inject Environment Keys Copy .env.example to .env and configure your foundation model provider (Anthropic is recommended for reasoning, OpenAI for generation):

ANTHROPIC_API_KEY="sk-ant-..."
OPENAI_API_KEY="sk-proj-..."

🎯 Running The Platform

EduPilot is designed to run anywhere. Choose your preferred interaction method:

Method A: The Interactive Web App (Recommended)

Boot the REST backend:

uvicorn main:app --reload --host 0.0.0.0 --port 8000

Then simply double-click frontend/index.html on your local machine to launch our completely decoupled, zero-build-step, ultra-premium chat interface.

Method B: Native MCP Integration (Claude Desktop)

Because EduPilot is an official MCP Server, you can pipe the agent orchestrator directly into Claude!

Simply modify your claude_desktop_config.json file:

{
  "mcpServers": {
    "edu-pilot-agent": {
      "command": "C:/path/to/venv/Scripts/python.exe",
      "args": ["C:/path/to/mcp_server.py"]
    }
  }
}

Note: Make sure to point to the absolute path of the python.exe inside your virtual environment so dependencies resolve properly!

Method C: The MCP Inspector

Want to hit the bare-metal MCP tools locally?

npx @modelcontextprotocol/inspector .\venv\Scripts\python.exe mcp_server.py

Built with ❤️ for the future of AGI-driven education.