Skip to main content
Glama

Django Styleguide MCP Server

by dmmeteo

Django Styleguide for MCP Servers

Ready-to-use Django Styleguide documentation for Model Context Protocol (MCP) servers in Cursor, Windsurf, Claude Desktop, and other AI editors.

What is this?

This repository takes the original Django Styleguide documentation as a git submodule, automatically splits it into smaller, AI-friendly files and provides access to them through the llms.txt format.

Result: Your AI assistant can easily find and use all Django best practices from the original styleguide.

How it works

  1. Git submodule: We include the original Django Styleguide as a submodule
  2. Automatic splitting: CLI tool splits the large README.md into separate files by sections
  3. llms.txt generation: Creates an index file with absolute URLs for each section
  4. Ready for consumption: MCP servers can easily access the documentation

What you get

  • 📄 18 separate files with Django best practices (Models, Services, APIs, etc.)
  • 🔗 llms.txt index with direct links to GitHub raw content
  • 🔄 Automatic updates when the original styleguide changes
  • 🤖 AI-friendly format for MCP servers

Example generated documentation

After processing you get this structure:

docs/ ├── models.md # Django models ├── services.md # Service layer ├── apis-serializers.md # APIs and serializers ├── urls.md # URL structure ├── settings.md # Django settings ├── errors-exception-handling.md # Error handling ├── testing.md # Testing ├── celery.md # Celery tasks └── ...other sections llms.txt # Index for MCP servers

llms.txt contains direct links:

# Table of Contents - [Models](https://raw.githubusercontent.com/dmmeteo/django-styleguide-mcp/main/docs/models.md) - [Services](https://raw.githubusercontent.com/dmmeteo/django-styleguide-mcp/main/docs/services.md) - [APIs & Serializers](https://raw.githubusercontent.com/dmmeteo/django-styleguide-mcp/main/docs/apis-serializers.md) ...

Integration with AI editors

Cursor

Add to ~/.cursor/mcp.json:

{ "mcpServers": { "django-styleguide": { "command": "uvx", "args": [ "--from", "mcpdoc", "mcpdoc", "--urls", "DjangoStyleguide:https://raw.githubusercontent.com/dmmeteo/django-styleguide-mcp/main/llms.txt", "--transport", "stdio" ] } } }

Add to your Cursor Rules:

For ANY questions about Django best practices, use the django-styleguide MCP server: + call list_doc_sources to get available sources + call fetch_docs to read llms.txt + analyze URLs in llms.txt based on the question + fetch relevant documentation sections + provide comprehensive answers based on Django Styleguide

Windsurf

Similar configuration in ~/.codeium/windsurf/mcp_config.json.

Claude Desktop

Add to ~/Library/Application\ Support/Claude/claude_desktop_config.json.

Keeping documentation up-to-date

Documentation automatically updates when the original Django Styleguide changes:

# 1. Git submodule automatically updates git submodule update --remote django-styleguide # 2. Regenerate documentation uv run python -m mcpdoc_split.cli django-styleguide/README.md \ --url-prefix "https://raw.githubusercontent.com/dmmeteo/django-styleguide-mcp/main" \ --base-path "/docs" \ --max-level 2 # 3. Commit changes git add docs/ llms.txt git commit -m "Update documentation from Django Styleguide"

Development

If you want to make changes or run locally:

# Clone repository git clone https://github.com/dmmeteo/django-styleguide-mcp.git cd django-styleguide-mcp # Initialize submodule git submodule update --init --recursive # Install dependencies uv sync # Run CLI uv run python -m mcpdoc_split.cli django-styleguide/README.md # Run tests uv run pytest

Project structure

mcpdoc_split/ # CLI tool for splitting documentation ├── cli.py # Command line interface ├── main.py # File splitting logic └── ... django-styleguide/ # Git submodule of original styleguide docs/ # Generated documentation files llms.txt # Index for MCP servers tests/ # Tests

Acknowledgments

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides AI assistants easy access to Django best practices by splitting comprehensive styleguide documentation into AI-friendly sections accessible through the Model Context Protocol.

  1. What is this?
    1. How it works
      1. What you get
        1. Example generated documentation
          1. Integration with AI editors
            1. Cursor
            2. Windsurf
            3. Claude Desktop
          2. Keeping documentation up-to-date
            1. Development
              1. Project structure
                1. Acknowledgments
                  1. Related projects

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol implementation that enables AI assistants to interact with markdown documentation files, providing capabilities for document management, metadata handling, search, and documentation health analysis.
                      Last updated -
                      14
                      467
                      39
                      TypeScript
                      MIT License
                      • Apple
                      • Linux
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol implementation that enables AI-powered access to documentation resources, featuring URI-based navigation, template matching, and structured documentation management.
                      Last updated -
                      8
                      Python
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A server that provides organized documentation content for various applications using the Model Context Protocol, enabling AI assistants to access quickstart guides and code examples.
                      Last updated -
                      Python
                      MIT License
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol plugin that helps AI assistants maintain persistent project context through structured markdown files, providing a systematic approach to tracking project goals, decisions, progress, and patterns.
                      Last updated -
                      3
                      431
                      17
                      JavaScript
                      MIT License
                      • Apple
                      • Linux

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/dmmeteo/django-styleguide-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server