MCP Academy

A Django backend for an academy with student and teacher accounts, course enrollment, assignments, submissions, attendance, a protected REST API, Django admin, and a local Model Context Protocol (MCP) stdio server.

Setup

The project expects Python 3.13+ and Windows PowerShell:

.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
.\.venv\Scripts\python.exe manage.py makemigrations academy
.\.venv\Scripts\python.exe manage.py migrate
.\.venv\Scripts\python.exe manage.py createsuperuser
.\.venv\Scripts\python.exe manage.py runserver

Admin interface: http://127.0.0.1:8000/admin/
Health check: http://127.0.0.1:8000/api/health/

Related MCP server: agent-kernel-mcp

API

All academy API endpoints require authentication. Obtain a token by posting username and password to /api/auth/token/, then send Authorization: Token <key>. New public registrations are always student accounts; create teacher and administrator accounts using the admin interface.

Teachers are scoped to their own courses, students can view their own records and submit work only for active enrollments, and administrators can manage all records. The Django admin provides the full management interface.

MCP stdio server

Install the requirements and migrate the database, then configure your MCP host to launch the server from the project directory:

{
  "mcpServers": {
    "mcp-academy": {
      "command": "C:\\path\\to\\MCPAcademy\\.venv\\Scripts\\python.exe",
      "args": ["-m", "academy.mcp_server"],
      "cwd": "C:\\path\\to\\MCPAcademy"
    }
  }
}

MCP tools and resources are separated into academy/mcp/tools.py and academy/mcp/resources.py; academy/mcp_server.py initializes Django and starts the stdio transport. Tools can list students and teachers, create accounts and courses, enroll students, create assignments, and record attendance. Read-only JSON resources are available at academy://students, academy://teachers, academy://courses, and academy://courses/{course_code}. MCP stdio tools run as the local OS user that launches the MCP client; use them only with trusted MCP clients and a trusted local project environment.

To run the MCP process directly, use:

.\.venv\Scripts\python.exe -m academy.mcp_server

Configuration

For deployment, set DJANGO_SECRET_KEY, DJANGO_DEBUG=0, and DJANGO_ALLOWED_HOSTS in the environment. The default SQLite database is intended for local development; configure a production database and HTTPS before deploying.