Django REST Framework + MCP Integration

A simple Django REST Framework application with integrated Model Context Protocol (MCP) server.

Overview

This project demonstrates the simplest way to add MCP (Model Context Protocol) support to any Django REST Framework project. Just copy one file (mcp_view.py) and add one URL pattern - that's it!

Features

• Django REST Framework API - Complete CRUD operations for User management
• Simple MCP Integration - Single file MCP view with auto-discovery
• Zero Dependencies - Only uses Django, DRF, and Python standard library
• Auto-discovery - Automatically finds DRF ViewSets and creates MCP tools

Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. Setup Database

python manage.py migrate

3. Start the Server

python manage.py runserver

The server provides:

• REST API: http://localhost:8000/api/users/
• MCP Endpoint: http://localhost:8000/mcp/
• Admin: http://localhost:8000/admin/

Adding MCP to Your Django Project

Want to add MCP support to your existing Django DRF project? It's incredibly simple:

1. Copy the MCP View

Copy django_mcp_project/mcp_view.py to your Django project.

2. Add URL Pattern

In your urls.py:

from your_project.mcp_view import MCPView

urlpatterns = [
    # your existing patterns...
    path("mcp/", MCPView.as_view(), name="mcp"),
]

3. That's it!

Your Django project now has MCP support. The view automatically discovers all your DRF ViewSets and creates MCP tools for them.

Testing MCP Integration

Test that your MCP endpoint is working:

curl -X POST http://127.0.0.1:8000/mcp/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

API Endpoints

User Management

• GET/POST /api/users/ - List all users / Create new user
• GET/PUT/PATCH/DELETE /api/users/{id}/ - User detail operations
• POST /api/users/{id}/activate/ - Activate user
• POST /api/users/{id}/deactivate/ - Deactivate user

MCP Integration

• POST /mcp/ - MCP JSON-RPC endpoint with auto-discovered tools

Project Structure

django-drf-mcp/
├── django_mcp_project/
│   ├── mcp_view.py          # 🌟 The magic file - copy this to any DRF project
│   ├── settings.py          # Django settings
│   ├── urls.py              # URL configuration with MCP endpoint
│   └── wsgi.py              # WSGI configuration
├── users/                   # Example Django app with User model
│   ├── models.py            # Extended User model
│   ├── serializers.py       # DRF serializers
│   ├── views.py             # DRF ViewSets
│   └── urls.py              # User API endpoints
├── manage.py                # Django management script
├── requirements.txt         # Dependencies
└── .vscode/                 # VS Code MCP client configuration

How It Works

The MCPView class in mcp_view.py:

1. Auto-discovers all Django apps and their ViewSets
2. Creates MCP tools for each CRUD operation (list, create, retrieve, update, destroy)
3. Provides JSON-RPC interface compatible with MCP clients
4. Requires zero configuration - just works out of the box

VS Code Integration

Add to your .vscode/mcp.json:

{
  "servers": {
    "django-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp/"
    }
  }
}

License

MIT License - feel free to use this in your projects!