DRF MCP Documentation

Enterprise-grade Model Context Protocol (MCP) integration for Django REST Framework with FastMCP 3.0

Automatically expose your Django REST Framework APIs as tools for AI agents via the Model Context Protocol. Zero configuration, maximum security, enterprise-ready.

Contents:

• Getting Started with Django MCP
  • Installation
  • Quick Start
  • Key Concepts
  • Inspector CLI
  • Permission Integration
  • Next Steps
• Architecture Guide
  • High-Level Architecture
  • Core Components
  • Data Flow Example
  • Permission Model
  • Transport Architecture
  • OpenTelemetry Integration
  • Performance Considerations
  • Extensibility
  • Next Steps
• Security Guide
  • Fundamental Principle: “Agent as User”
  • Authentication
  • Permission Classes
  • Row-Level Security (Object-Level Permissions)
  • Scope-Based Access (Fine-Grained Permissions)
  • Audit Logging
  • Transport Security
  • Data Protection
  • Rate Limiting
  • Secrets Management
  • Compliance
  • Security Checklist
  • Next Steps
• Documented in individual module docstrings and type hints

Overview

DRF MCP transforms your Django REST Framework views into AI-native tools via the Model Context Protocol standard. Built on FastMCP 3.0, it automatically:

• 🔍 Discovers all DRF views and ViewSets in your Django URLconf

• 🔧 Exposes them as MCP tools with auto-generated JSON schemas

• 🔐 Secures with DRF’s permission system (no security bypass)

• ⚡ Async-first execution for non-blocking LLM interactions

• 📊 Traces with OpenTelemetry for observability

• 🚀 Scales with stateless, transport-agnostic architecture

Quick Start

# In your Django project
from drf_mcp import DRFMCP
from myapp.views import CustomerViewSet

# Initialize MCP server
mcp = DRFMCP("MyEnterpriseAPI")

# Option 1: Register specific ViewSets
mcp.register_viewset(CustomerViewSet, namespace="crm")

# Option 2: Auto-discover all DRF views
mcp.autodiscover()

# Run server (stdio, HTTP, or SSE transport)
if __name__ == "__main__":
    mcp.run()

Installation

uv add drf-mcp

Or with pip:

pip install drf-mcp

Indices and tables

• Index

• Module Index

• Search Page