django-mcp-discovery 0.1.0

Exposes /.well-known/mcp-server on Django projects for MCP agent discovery. Implements draft-serra-mcp-discovery-uri.

django-mcp-discovery

Exposes /.well-known/mcp-server on your Django project so AI agents can discover your MCP server via mcp://.

Implements draft-serra-mcp-discovery-uri.

Installation

pip install django-mcp-discovery

Setup

1. Add to INSTALLED_APPS:

# settings.py
INSTALLED_APPS = [
    ...
    'mcp_discovery',
]

2. Include URLs:

# urls.py
from django.urls import path, include

urlpatterns = [
    ...
    path('', include('mcp_discovery.urls')),
]

3. Done. Visit https://yoursite.com/.well-known/mcp-server to verify.

Configuration (optional)

# settings.py
MCP_DISCOVERY = {
    'NAME': 'My Site MCP Server',
    'ENDPOINT': 'https://mysite.com/mcp/',
    'DESCRIPTION': 'My site MCP endpoint',
    'AUTH': 'none',              # none | apikey | oauth2
    'CAPABILITIES': ['tools', 'resources'],
    'CATEGORIES': ['e-commerce', 'fashion'],
    'LANGUAGES': ['it', 'en'],
    'CONTACT': '[e-mail]',
    'DOCS': 'https://mysite.com/mcp/docs/',
    'CRAWL': True,               # False to opt out of indexing
}

Without any configuration the plugin auto-detects:

• Name — from django.contrib.sites or SITE_NAME setting
• Endpoint — from SITE_URL or first non-localhost ALLOWED_HOSTS
• Language — from LANGUAGE_CODE setting

Example output

{
  "mcp_version": "2025-06-18",
  "name": "My Shop MCP Server",
  "endpoint": "https://myshop.com/mcp/",
  "transport": "http",
  "auth": { "type": "none" },
  "capabilities": ["tools", "resources"],
  "languages": ["it"],
  "crawl": true
}

Links

• mcpstandard.dev — specification
• IETF Draft
• GitHub Discussion #2462
• WordPress plugin