Django MCP 서버는 Django용 Model Context Protocol(MCP) 확장 기능의 구현체입니다. 이 모듈은 MCP 클라이언트와 AI 에이전트가 모든 Django 애플리케이션과 원활하게 상호작용할 수 있도록 합니다.

🚀 D Agent와 MCP 클라이언트 도구가 Django와 상호작용할 수 있도록 하는 Django 스타일의 선언형 스타일 도구들.
🚀 AI 에이전트와 MCP 도구에 대해 Django 모델을 노출하여 2줄짜리 코드로 안전하게 쿼리할 수 있습니다.
🚀 Django Rest Framework API를 한 번의 주석으로 MCP 도구로 변환할 수 있습니다.
✅ 인프라 변경 없이 WSGI와 ASGI 모두를 작업하고 있습니다.
✅ Claude AI와의 원격 통합으로 검증됨.
🤖 MCP를 지원하는 모든 MCP 클라이언트나 AI 에이전트(Google Agent Developement Kit, Claude AI, Claude Desktop 등)는 애플리케이션과 상호작용할 수 있습니다.

모든 기여자 커뮤니티에 진심으로 감사드립니다 🙏

Smart GTS 소프트웨어 엔지니어링이 세심하게 유지보수합니다 ✨.

MIT 라이선스 하에 라이선스를 받았습니다.

---

특징

• 장고 모델과 로직을 MCP 도구로 노출.
• Django 앱 내에서 MCP 엔드포인트를 제공합니다.
• AI 에이전트, MCP 클라이언트, 또는 Google ADK와 같은 도구와 쉽게 통합할 수 있습니다.

---

퀵 스타트

1️# 설치

또는 GitHub에서 직접 방문할 수도 있습니다:

---

2️# 그리고 Django 설정

Django MCP Server

Django MCP Server is an implementation of the Model Context Protocol (MCP) extension for Django. This module allows MCP Clients and AI agents to interact with any Django application seamlessly.

🚀 Django-Style declarative style tools to allow AI Agents and MCP clients tool to interact with Django. 🚀 Expose Django models for AI Agents and MCP Tools to query in 2 lines of code in a safe way. 🚀 Convert Django Rest Framework APIs to MCP tools with one annotation. ✅ Working on both WSGI and ASGI without infrastructure change. ✅ Validated as a Remote Integration with Claude AI. 🤖 Any MCP Client or AI Agent supporting MCP , (Google Agent Developement Kit, Claude AI, Claude Desktop …) can interact with your application.

Many thanks 🙏 to all the contributor community

Maintained ✨ with care by Smart GTS software engineering.

Licensed under the MIT License.

---

Features

• Expose Django models and logic as MCP tools.
• Serve an MCP endpoint inside your Django app.
• Easily integrate with AI agents, MCP Clients, or tools like Google ADK.

---

Quick Start

1️⃣ Install

pip install django-mcp-server

Or directly from GitHub:

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

---

2️⃣ Configure Django

✅ Add mcp_server to your INSTALLED_APPS:

INSTALLED_APPS = [
    # your apps...
    'mcp_server',
]

✅ Add the MCP endpoint to your urls.py:

from django.urls import path, include

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

By default, the MCP endpoint will be available at /mcp.

---

3️⃣ Define MCP Tools

In mcp.py create a subclass of ModelQueryToolset to give access to a model :

from mcp_server import ModelQueryToolset
from .models import *

class BirdQueryTool(ModelQueryToolset):
    model = Bird

    def get_queryset(self):
        """self.request can be used to filter the queryset"""
        return super().get_queryset().filter(location__isnull=False)

class LocationTool(ModelQueryToolset):
    model = Location

class CityTool(ModelQueryToolset):
    model = City

Or create a sub class of MCPToolset to publish generic methods (private _ methods are not published)