Django+快速MCP+MCP检查器
该项目将FastMCP与Django ASGI应用程序集成，支持OAuth2承载令牌和基于会话的身份验证。
该项目将FastMCP（模型上下文协议）集成到Django ASGI应用程序中。它实现了基于Node.js的MCP Inspector工具和Django支持的FastMCP工具之间的安全、可流式和经过身份验证的通信。
✅ 特征：
- 通过Django OAuth工具包进行OAuth2和基于会话的身份验证
- MCP检查器中继会话的代理令牌支持
- MCP客户端通信的流式HTTP传输支持
- OAuth发现的元数据端点
- 用于混合承载+会话认证的可插拔中间件
非常适合使用MCP Inspector将Django admin/UX与实时工具API相结合的设置。
- 测试管理员用户：demo/demo
📦 项目结构
.
├── djproject/
│ ├── settings.py
│ └── asgi.py ← Mounts MCP app
├── mcp_app/
│ ├── auth_middleware.py
│ └── mcp_server.py
├── manage.py
└── requirements.txt⚙️ 安装说明
1.安装要求
pip install -r requirements.txt确保 django, django-oauth-toolkit，以及 fastmcp 包括在内。
2.Django设置
确保您的 INSTALLED_APPS 包括：
"oauth2_provider",
"mcp_app",3.在中配置ASGI asgi.py
from starlette.applications import Starlette
from starlette.routing import Mount, Route
from starlette.middleware.cors import CORSMiddleware
from starlette.middleware import Middleware
from starlette.staticfiles import StaticFiles
from django.core.asgi import get_asgi_application
from pathlib import Path
from django.conf import settings
from mcp_app.mcp_server import djmcp as mcp_instance
from mcp_app.auth_middleware import CombinedAuthMiddleware
from mcp_app.metadata import oauth_authorization_server, oauth_protected_resource
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "djproject.settings")
django_application = get_asgi_application()
middleware = [
Middleware(CORSMiddleware, allow_origins=["*"], allow_methods=["*"], allow_headers=["*"]),
Middleware(CombinedAuthMiddleware),
]
mcp_asgi_app = mcp_instance.http_app(path="/", middleware=middleware)
application = Starlette(
routes=[
Route("/.well-known/oauth-authorization-server", oauth_authorization_server, methods=["GET", "OPTIONS"]),
Route("/.well-known/oauth-protected-resource", oauth_protected_resource, methods=["GET", "OPTIONS"]),
Mount("/mcp", mcp_asgi_app),
Mount("/", django_application),
],
lifespan=mcp_asgi_app.lifespan
)
if settings.STATIC_ROOT and Path(settings.STATIC_ROOT).exists():
application.routes.insert(
2,
Mount("/static", StaticFiles(directory=settings.STATIC_ROOT), name="static")
)🔐 组合认证中间件
位于 mcp_app/auth_middleware.py.
- 检查
Authorization: Bearer ...并使用DOT进行验证 - 回到Django
sessionid曲奇 - 接受
x-mcp-proxy-session-token用于受信任的代理转发请求
🛠️ MCP工具示例
from fastmcp import FastMCP
djmcp = FastMCP(name="django_mcp")
@djmcp.tool
def echo(message: str) -> str:
return f'{{"Echo": "{message}"}}'🧪 调试提示
- 确保
is_valid()来自DOT的数据在没有参数的情况下使用。 - 中间件记录错误
logger.error(...)如果响应失败。 - 请注意：
_StreamingResponse对象不支持.body().
______________________________________________________________________
许可证
该项目根据MIT许可证获得许可。请随时根据自己的需求进行调整和扩展。