django-silk-mcp

An MCP server that exposes django-silk profiling data as tools for any MCP-compatible AI coding assistant. Enables query-level investigation and optimization directly from your conversation — N+1 detection, EXPLAIN ANALYZE, over-fetch analysis, and Python profiling without leaving your editor.

Installation

pip install django-silk-mcp
# or
uv add django-silk-mcp

Configuration

1. Add to INSTALLED_APPS

INSTALLED_APPS = [
    ...
    "silk",
    "django_silk_mcp",
]

2. Configure your MCP client

Expose the MCP server as a URL inside your Django app. Works on both WSGI and ASGI with no extra infrastructure.

Add to your root urls.py:

urlpatterns = [
    ...
    path("silk/", include("silk.urls", namespace="silk")),
    path("silk/mcp", include("django_silk_mcp.urls")),
]

This serves the MCP endpoint at /silk/mcp. The MCP server runs as part of your Django app — no separate process needed, it shares the same port as your dev server. Then configure your MCP client:

Claude Code:

claude mcp add silk-mcp --transport http http://localhost:8000/silk/mcp

Cursor: Go to Settings → Toos & MCPs → New MCP Server and add a new server with the following configuration:

{
  "mcpServers": {
    "silk-mcp": {
      "url": "http://localhost:8000/silk/mcp"
    }
  }
}

The same URL works with any MCP-compatible AI tool.

Security

Warning: The MCP endpoint uses AllowAny with no authentication by default, because MCP clients (Claude Code, Cursor, etc.) connect over plain HTTP and do not send credentials. This is intentional for local development but must not be exposed in production.

Silk profiling data includes raw SQL query strings, which can contain business data at runtime (user IDs, emails, search terms, etc.). Anyone who can reach the Django host can read this data through the MCP endpoint.

Recommended: Only mount in DEBUG mode:

# urls.py
from django.conf import settings

if settings.DEBUG:
   urlpatterns = [
     path("silk/", include("silk.urls", namespace="silk")),
     path("silk/mcp", include("django_silk_mcp.urls")),
   ]

Tools

Usage

# Hit an endpoint first so Silk has data
curl http://localhost:8000/api/your-endpoint/

# Then ask your AI assistant
# "What are the slowest endpoints?"
# "Find N+1 queries in /api/your-endpoint/"
# "Run EXPLAIN on the slow queries for /api/your-endpoint/"