drf-mcp-docs

Overview

drf-mcp-docs transforms your DRF API documentation into MCP resources and tools that AI agents can use to understand your API and generate frontend integration code. It supports multiple schema generators (drf-spectacular, drf-yasg, DRF built-in) and provides both stdio and HTTP transport options. The server exposes API documentation as browseable resources and offers tools for searching endpoints, retrieving examples, and generating client code for JavaScript/TypeScript, Python, and cURL.

Try asking AI

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

• search_endpointssearch_endpoints(query, method?, tag?)

  Search endpoints by keyword

  Try:Show me all product endpointsTry:Find GET endpoints related to users
• get_endpoint_detailget_endpoint_detail(path, method)

  Get full endpoint documentation

  Try:Get details for POST /api/products/Try:Show me the documentation for the /api/users endpoint
• get_request_exampleget_request_example(path, method)

  Get example request body and parameters

  Try:Show me an example request for creating a productTry:What does the request body look like for updating a user?
• get_response_exampleget_response_example(path, method, status_code?)

  Get example response for an endpoint

  Try:What does the response look like when getting a user?Try:Show me a 404 error response for products
• generate_code_snippetgenerate_code_snippet(path, method, language?, client?)

  Generate integration code with types and docs

  Try:Generate React hook with fetch for creating productsTry:Give me TypeScript code for calling the /api/users endpoint
• list_schemaslist_schemas()

  Get all data model names and descriptions

  Try:List all schemas in the APITry:What data models are available?
• get_schema_detailget_schema_detail(name)

  Get full schema with all fields and types

  Try:Show me the full Product schemaTry:What fields are in the Order model?

Comparable tools

Installation

pip install drf-mcp-docs
# With specific schema generator:
pip install drf-mcp-docs[spectacular]   # recommended
pip install drf-mcp-docs[yasg]

INSTALLED_APPS = [
    # ...
    'rest_framework',
    'drf_mcp_docs',
]

python manage.py runmcpserver --transport stdio

python manage.py runmcpserver --transport streamable-http --host 0.0.0.0 --port 8100

{
  "mcpServers": {
    "my-api-docs": {
      "command": "python",
      "args": ["manage.py", "runmcpserver", "--transport", "stdio"],
      "cwd": "/path/to/your/django/project"
    }
  }
}

Compare drf-mcp-docs with