Django AI Boost MCP
MCP-сервер раскрывает ассистенту модели, маршруты, миграции и настройки Django-проекта через инструменты только для чтения.
- 114 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- query_model читает содержимое таблиц проекта, в том числе персональные данные, и передает его модели.
- SSE-режим открывает сетевой порт и защищается только токеном.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/django-ai-boostОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- query_model читает содержимое таблиц проекта, в том числе персональные данные, и передает его модели.
- SSE-режим открывает сетевой порт и защищается только токеном.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Django AI Boost запускается в окружении проекта и отвечает ассистенту данными самого приложения. Инструменты показывают версии Django и Python, установленные приложения, модели с полями и связями, URL-маршруты, схему базы, миграции с признаком применения и команды manage.py. Отдельные вызовы превращают имя маршрута в адрес, достают адрес объекта через get_absolute_url, запускают системные проверки Django и читают последние строки файловых логов. Через `query_model` ассистент выбирает объекты модели с фильтрами, сортировкой и лимитом: по умолчанию 100 объектов, максимум 1000. Есть и MCP-промпт для поиска по документации: он собирает запрос со ссылками на ту версию Django, которая стоит в проекте. Идея взята у Laravel Boost.
Для кого. Django-разработчикам, чей ассистент гадает о моделях и маршрутах, потому что не видит живой проект.
Подходит, если
- Ассистент пишет запрос к ORM и должен знать реальные поля и связи моделей.
- Перед миграцией надо понять, какие из них еще не применены.
- Маршрут вызывается по имени, и нужен готовый адрес для теста.
- Проект падает при запуске, и ассистент читает свежие строки лога вместе с результатом системных проверок.
Не подходит, если
- Нужна запись в базу: инструменты только читают.
- Проект на другом фреймворке, а не на Django.
- Логи пишутся только в консоль и без файлового обработчика читать нечего.
Пример запроса к агенту
Покажи модели приложения blog с полями и связями, затем список непримененных миграций.MCP
- Транспорт
- stdio, sse
- Авторизация
- не нужна
Переменные окружения
`DJANGO_SETTINGS_MODULE`обязательная- Путь к модулю настроек проекта, например myproject.settings.
`DJANGO_MCP_AUTH_TOKEN`секрет- Токен для SSE-режима, обязательный при DEBUG=False.
`DJANGO_MCP_MAX_LOG_LINES`- Максимум строк, которые читает read_recent_logs, по умолчанию 100.
Ограничения
Серверу нужен доступ к настройкам проекта: переменная `DJANGO_SETTINGS_MODULE` обязательна, а при проблемах с импортом добавляется `PYTHONPATH`. Журнал читается только из файловых обработчиков LOGGING, консольные логи недоступны. На больших проектах часть клиентов, например PyCharm, обрезает длинный вывод list_models, поэтому приложения фильтруют параметром `app_labels`. По умолчанию работает stdio без аутентификации и портов. SSE-режим открывает сетевой порт, а при DEBUG=False без токена сервер не стартует. Через query_model ассистент видит данные таблиц, включая личные.
Как отключить. Удалите блок django-ai-boost из `.mcp.json` или настроек клиента и при необходимости выполните `pip uninstall django-ai-boost`. Запущенный SSE-сервер остановите отдельно.
Частые вопросы
Как подключить Django AI Boost к Claude Code?
Создайте `.mcp.json` в корне проекта с командой `uv run django-ai-boost --settings myproject.settings` и переменной `DJANGO_SETTINGS_MODULE`, затем перезапустите расширение.
Может ли сервер менять данные?
Нет. Все инструменты работают на чтение, query_model выполняет только выборки через менеджер ORM.
Как защитить SSE-режим?
Задайте токен в `DJANGO_MCP_AUTH_TOKEN` или флагом `--auth-token`. При DEBUG=False с SSE токен обязателен, при stdio флаг приводит к ошибке.
Что делать, если list_models обрезается?
Передайте `app_labels` со списком нужных приложений, например blog и auth. Ответ станет короче лимита клиента.
Откуда берется адрес документации в промпте?
Промпт search_django_docs берет версию Django из текущего проекта и ведет на документацию этой версии.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер, гайдлайны и скиллы Laravel: агент видит схему БД, логи и версии пакетов и ищет по документации экосистемы
Пакет для Laravel и Lumen, который добавляет MCP-эндпоинт в маршруты приложения и подключает к нему ваши инструменты
Пять скиллов по Django от Vinta Software: ORM и DRF, Celery, безопасные миграции PostgreSQL, классы Classy DRF и ревью кода
MCP-сервер для PostgreSQL с подбором индексов, планами EXPLAIN, проверкой здоровья базы и режимом только чтения
Скилл расспрашивает о проекте и пишет рабочий Django с актуальными пакетами, настройками и CI по свежим справочникам.
OpenAPI-MCP превращает операции документа OpenAPI в инструменты MCP с белым списком операций и предпросмотром запроса
Коротко о README
Сервер собран на FastMCP и опубликован в официальном реестре MCP. Клиентов описано много: Cursor, Claude Desktop, Copilot, Claude Code, Cline и Zed.