Django MCP Server

Django MCP Server

site icon
2025.05.12 0
PythonDjango 扩展MCP 协议AI 代理集成开发效率
Django MCP Server 是一个基于 Django 的 Model Context Protocol (MCP) 扩展实现,允许 MCP 客户端和 AI 代理与任何 Django 应用无缝交互。它支持在现有的 WSGI 应用中运行,并提供了流式 HTTP 传输(无状态)功能。未来计划支持有状态传输和服务器发送事件(SSE)响应。
View on GitHub

Overview

基本能力

产品定位

Django MCP Server 是一个用于 Django 应用的 MCP 协议扩展,旨在简化 AI 代理和 MCP 客户端与 Django 应用的交互。

核心功能

  • 将 Django 模型和逻辑暴露为 MCP 工具。
  • 在 Django 应用中提供 MCP 端点。
  • 轻松集成 AI 代理、MCP 客户端或工具(如 Google ADK)。

适用场景

  • AI 代理与 Django 应用的交互。
  • 开发需要与 MCP 协议兼容的工具或客户端。
  • 快速构建支持 MCP 协议的 Django 后端服务。

工具列表

  • list_species: 列出所有物种及其数量。
  • increment_species: 增加特定物种的数量。
  • get_species_count: 获取特定物种的数量。

常见问题解答

  • 如何测试 MCP 服务器? 可以使用 MCP Inspector 工具或任何兼容的 MCP 客户端进行测试。
  • 如何启用授权? 可以使用 DRF 注解和 OAuth2 集成来启用授权。

使用教程

使用依赖

确保已安装 Python 和 Django。

安装教程

pip install django-mcp-server

或直接从 GitHub 安装:

pip install git+https://github.com/omarbenhamid/django-mcp-server.git

配置 Django

  1. mcp_server 添加到 INSTALLED_APPS
INSTALLED_APPS = [
    # your apps...
    'mcp_server',
]
  1. 将 MCP 端点添加到 urls.py
from django.urls import path, include

urlpatterns = [
    # your urls...
    path("", include('mcp_server.urls')),
]

调试方式

  1. 使用测试脚本 test/test_mcp_client.py
  2. 使用 MCP Inspector 工具
  3. 使用任何兼容的 MCP 客户端。

许可证

该项目遵循 MIT 开源许可条款。