django-mcp-server

Overview

Django MCP Server is a Django extension that provides MCP (Model Context Protocol) capabilities to any Django application, whether using WSGI or ASGI. It allows exposing Django models as MCP tools with minimal code, enabling AI agents to query and interact with application data securely. The server supports both async and sync operations and integrates seamlessly with Django Rest Framework APIs.

Try asking AI

After installing, here are 3 things you can ask your AI assistant:

• BirdQueryTool

  Query Bird models with location information

  Try:Find all birds with a locationTry:Get birds by location
• LocationTool

  Query Location models

  Try:List all locationsTry:Find location by name
• CityTool

  Query City models

  Try:List all citiesTry:Find city by name
• add

  Add two numbers together

  Try:Add 5 and 3Try:Calculate the sum of two numbers
• send_email

  Send an email with specified subject and body

  Try:Send an email to test@example.comTry:Contact user about their order
• get_species_count

  Get count of a bird species by name

  Try:How many robins are there?Try:Get count for sparrows
• increment_species

  Increment the count of a bird species

  Try:Increase robin count by 5Try:Add 10 more sparrows
• get_foo_bar

  Get first FooBar instance

  Try:Get the first FooBar recordTry:Retrieve initial FooBar
• MyModelView

  Create instances of MyModel

  Try:Create a new MyModel instanceTry:Add a new item to MyModel

Comparable tools

Installation

pip install django-mcp-server

INSTALLED_APPS = [
    # your apps...
    'mcp_server',
]

from django.urls import path, include

urlpatterns = [
    # your urls...
    path("", include('mcp_server.urls')),
]

from mcp_server import ModelQueryToolset
from .models import *

class BirdQueryTool(ModelQueryToolset):
    model = Bird

{
  "mcpServers": {
    "django_mcp": {
      "command": "/path/to/interpreter/python",
      "args": [
        "/path/to/your/project/manage.py",
        "stdio_server"
      ]
    }
  }
}

Compare django-mcp-server with