django-telescope — MCP-сервер для Claude Code: функции и установка
MCP-сервер помогает ИИ-ассистенту изучать Django-проект: смотреть модели, схему базы данных, настройки и логи. Пригодится, когда нужно дать агенту контекст кодовой базы.
claude mcp add django-telescope -e DJANGO_SETTINGS_MODULE=<DJANGO_SETTINGS_MODULE> -- uvx django-telescopeЧто делает django-telescope
Сервер предоставляет инструменты для изучения Django-проекта: они показывают модели, URL и команды управления, структуру базы данных, миграции и связи. Настройки можно запрашивать по точечному пути, а журналы приложения — просматривать с фильтрами. Все операции только для чтения, поэтому сервер не меняет данные проекта.
Для запуска нужна настройка Django: задайте DJANGO_SETTINGS_MODULE или передайте имя модуля через --settings. По умолчанию сервер общается через stdio; для подключения по сети используйте транспорт SSE. В production с SSE обязателен токен Bearer, а у stdio авторизации нет. Это важно учитывать, если вы открываете сервер для удалённого доступа.
Для Claude Code сервер можно добавить командой claude mcp add и запустить через uvx. Пакет также описывает настройки для Codex, Cursor и других MCP-клиентов. Перед запуском проверьте, что указали модуль настроек именно своего Django-проекта.
Какие задачи решает
- показать модели и команды управления Django-проекта
- проверить схему базы данных, миграции и связи
- найти нужное значение в настройках Django
- просмотреть журналы приложения с фильтрами
Примеры запросов агенту
- Покажи модели и команды управления в моём Django-проекте.
- Проверь схему базы данных и связанные модели.
- Найди в настройках Django значение для базы данных и покажи последние журналы приложения.
Как установить django-telescope
Командой платформы
claude mcp add django-telescope -e DJANGO_SETTINGS_MODULE=<DJANGO_SETTINGS_MODULE> -- uvx django-telescopeВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from django-telescope <команда>
Командой платформы
codex mcp add django-telescope --env DJANGO_SETTINGS_MODULE=<DJANGO_SETTINGS_MODULE> -- uvx django-telescopeВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from django-telescope <команда>
Файл настроек
{
"mcpServers": {
"django-telescope": {
"command": "uvx",
"args": [
"django-telescope"
],
"env": {
"DJANGO_SETTINGS_MODULE": "<DJANGO_SETTINGS_MODULE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from django-telescope <команда>
Файл настроек
{
"servers": {
"django-telescope": {
"type": "stdio",
"command": "uvx",
"args": [
"django-telescope"
],
"env": {
"DJANGO_SETTINGS_MODULE": "<DJANGO_SETTINGS_MODULE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from django-telescope <команда>
Командой платформы
gemini mcp add -e DJANGO_SETTINGS_MODULE=<DJANGO_SETTINGS_MODULE> django-telescope uvx django-telescopeВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from django-telescope <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о django-telescope
Как установить django-telescope в Claude Code?
Выполните claude mcp add django-telescope -e DJANGO_SETTINGS_MODULE=<DJANGO_SETTINGS_MODULE> -- uvx django-telescope. Замените плейсхолдер на модуль настроек своего Django-проекта.
Что делает django-telescope?
Он передаёт MCP-клиенту сведения о Django-проекте: модели, URL, команды управления, структуру базы, настройки и журналы. Инструменты работают только на чтение.
Нужен ли токен для подключения?
Для SSE в production токен Bearer обязателен. Транспорт stdio не поддерживает аутентификацию.
