基于 Model Context Protocol (MCP) 的 Django 项目服务器,为 AI 助手提供项目结构发现、数据库内省、配置查询和日志读取等只读能力,支持 Cursor、Claude Desktop、Copilot 等 AI 工具集成。
Django AI Boost 是一个生产就绪的 Model Context Protocol (MCP) 服务器,专为 Django 应用程序开发设计。它允许 AI 助手(如 Cursor、Claude Desktop、GitHub Copilot)深入理解 Django 项目结构,从而提供更准确的代码建议和调试支持。
核心能力#
项目发现:自动列出所有 Django 模型、字段、类型、关系,显示完整的 URL 模式(包括嵌套 include),列出所有可用的管理命令。
数据库内省:查看完整的数据库架构(表、列、类型、索引、外键),监控迁移状态,理解表之间的关系。
配置访问:使用点表示法查询 Django 设置(如 DATABASES.default.ENGINE),获取应用信息(Django/Python 版本、已安装应用、中间件、数据库引擎、调试模式)。
日志读取:访问最近的应用程序日志,支持过滤功能。
数据查询:使用 Django ORM 安全查询模型(只读操作),支持过滤、排序、分页。
URL 操作:获取模型实例的绝对 URL,反向解析命名 URL 模式。
安全特性#
- 所有工具都是安全的只读操作
- SSE 传输支持 Bearer 令牌认证
- 当 DEBUG=False 时自动要求身份验证
- stdio 传输无认证(仅限本地/受信任环境)
安装与使用#
# 安装(推荐使用 uv)
uv pip install django-ai-boost
# 或使用 pip
pip install django-ai-boost
# 运行
export DJANGO_SETTINGS_MODULE=myproject.settings
django-ai-boost
# SSE 传输模式
django-ai-boost --settings myproject.settings --transport sse --port 8000
MCP 工具列表#
| 工具名 | 功能 |
|---|---|
application_info | 获取应用信息(Django/Python 版本、已安装应用等) |
get_setting | 查询 Django 设置(点表示法) |
list_models | 列出所有模型、字段、关系 |
list_urls | 列出所有 URL 模式 |
database_schema | 查看数据库架构 |
list_migrations | 查看迁移状态 |
list_management_commands | 列出管理命令 |
get_absolute_url | 获取模型实例 URL |
reverse_url | 反向解析 URL |
query_model | 安全查询模型数据 |
AI 工具配置示例#
{
"mcpServers": {
"django-ai-boost": {
"command": "django-ai-boost",
"args": ["--settings", "myproject.settings"],
"env": {
"DJANGO_SETTINGS_MODULE": "myproject.settings",
"PYTHONPATH": "/path/to/your/django/project"
}
}
}
}
环境要求#
- Python >=3.12
- Django >=4.2
- FastMCP >=2.14.5
适用场景#
- AI 辅助 Django 开发
- 新团队成员快速了解项目结构
- 调试和问题排查
- 代码生成(基于项目规范)
支持的 AI 工具#
Cursor(内置 MCP 支持)、Claude Desktop、GitHub Copilot (VS Code)、Claude Code (VS Code)、OpenAI ChatGPT Desktop、Cline (VS Code)、Zed Editor、任何 MCP 兼容客户端。