EduSmart AI Tutor MCP Server
Allows EduSmart AI Tutor to use OpenAI models for explaining concepts, generating novel questions, and grading free-text conceptual answers.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
EduSmart AI Tutor
An AI-powered personalized learning platform exposed through a Model Context Protocol (MCP) server, so an MCP-compatible AI client (Claude, ChatGPT Apps SDK, or any MCP host) can tutor a student through a real learning-workflow platform — knowledge retrieval, assessment, mastery tracking, and personalized recommendations — not a generic chatbot with a system prompt.
Student → AI Tutor → Knowledge → Assessment → Mastery → Next Action → Demonstrated CompetenceWhat this is
A relational learner model (PostgreSQL/SQLite): students, courses, a skill prerequisite graph, mastery, attempts, assessments, projects, and an append-only learning history.
A real RAG pipeline: document ingestion → chunking → embeddings → a FAISS vector index → a retriever that joins back to source metadata for attribution.
A deterministic-first learning engine: mastery calculation, prerequisite resolution, and the
get_next_learning_actionrecommendation are pure functions — no LLM call decides them.An LLM provider abstraction (stub / OpenAI / Anthropic) used only where language generation genuinely helps: explaining a concept, generating novel questions, and grading free-text conceptual answers.
A LangGraph tutor workflow that routes a request through explicit nodes (classify intent → load student state → teach/practice/assessment/project → update learning state → recommend next step) instead of an unconstrained agent loop.
A 17-tool MCP server (
app/mcp/server.py) plus an equivalent REST API (app/main.py), both thin adapters over the same authorization-enforcing service layer.
Related MCP server: OLCP
Status
59 automated tests, all passing, across unit, integration, MCP, RAG, and evaluation suites —
run python -m pytest tests/ -q to verify. See docs/DEVELOPMENT.md for a
phase-by-phase IMPLEMENTED/TESTED/PARTIALLY-IMPLEMENTED breakdown (Docker was written but not
executed in this build environment; everything else has been run for real, not just written).
Quick start
python -m venv .venv && source .venv/Scripts/activate # or .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env
python -m alembic upgrade head
python scripts/seed_data.py
python scripts/ingest_documents.py
uvicorn app.main:app --reload & # REST API on :8000
python scripts/run_mcp_server.py & # MCP server on :8765
python -m pytest tests/ -q # 59 passedFull setup, every command explained, and known pitfalls: docs/DEVELOPMENT.md.
Documentation
Doc | Covers |
System diagram, layering, deterministic-vs-LLM decisions, technology inventory | |
The 17 MCP tools, authentication approach, security boundaries, ChatGPT integration readiness | |
Ingestion → chunking → embeddings → FAISS → retrieval, and why each part is swappable | |
Schema (24 tables), ER diagram, PostgreSQL/SQLite portability | |
Authn/authz model, prompt-injection defenses, what's out of scope | |
Real measured retrieval/grading/mastery-model results | |
Docker Compose, configuration, production gaps | |
REST endpoint reference | |
Full local setup, test suite layout, phase-by-phase status |
License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Open-source AI courses taught by your AI tutor in conversation, with progress saved by MCP tools.
Connect AI clients to your Dactic work context through a hosted MCP service.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server for tracking student learning via a knowledge graph, with spaced repetition scheduling and intelligent queries to identify gaps, misconceptions, and optimal next steps.721 PyPI2MIT
- FlicenseNot gradedqualityBmaintenanceEnables portable English language instruction through MCP, owning learner identity, curriculum, and learner model while any host LLM delivers conversational teaching, sessions, and assessment.1-
- AlicenseBqualityBmaintenanceEnables AI agents to act as a state-driven tutoring engine over MCP, with server-side mastery estimation, prerequisite checks, evidence-based assessment, and FSRS spaced review scheduling.581MIT
- AlicenseBqualityBmaintenanceEnables MCP-compatible AI clients to connect to a self-hosted DeepTutor instance for accessing learning data, study tools, practice workflows, knowledge retrieval, and learning-state management.581Apache 2.0