如何在 Django 中集成 MCP Server

背景说明

有几个原因导致 Django 集成 MCP Server 比较麻烦

目前支持的 MCP 服务是 SSE 协议的，需要长连接，但一般来讲 Django 是传统的连接方式
MCP 的 Python SDK 直接封装了 Starlette 作为 ASGI 服务的提供，和 Django 的框架并不兼容
目前无法直接将 Starlette 的服务，作为 Django 某个子路由下的处理函数直接使用，我有看到一个插件项目，在处理这个事情，但目前我自己没有运行成功，欢迎交流

所以最简单的思路是 MCP 跑在另一个端口上，通过 Django ORM 来获取 Django 项目中的数据。

但如果希望集成到一个项目中使用，需要做一些调整：

使用 ASGI 来处理服务请求
修改 asgi.py 中的应用，指定部分路由由 Starlette 或其他 ASGI 服务处理
针对 Django 数据库查询语句，进行异步环境下的使用调整

第一步：使用 ASGI

官方文档推荐了几个 ASGI 服务，可以用来替代原有的 uwsgi，包括 Daphne、Hypercorn、Uvicorn，这里以 Daphne 为例说明，因为 Daphne 提供了和 Django 更好的集成效果

原有项目中 wsgi.py 下的相应调整，需要放到 asgy.py 下

调整 settings.py 文件

python 复制代码

# settings.py
INSTALLED_APPS = [
    'daphne', # 需要放在第一个
	...
]
ASGI_APPLICATION = '项目名称.asgi.application'

使用 Daphne 来接受请求，需要运行

shell 复制代码

# 提供接口
daphne -b 127.0.0.1 -p 8001 your_project_name.asgi:application
# 通过 socket 文件
daphne -u /path/to/your/project/daphne.sock your_project_name.asgi:application

# 调试
python manage.py runserver

至于 Daphne 和 Nginx 或 Apache 的配置文件，和之前使用 uwsgi 没有太大差异

第二步：修改 asgi.py 中的应用

主要目的有几个

引入 mcp 服务的 starlette app，对部分路径进行处理
对于其他路径，仍由 Django 进行处理

这里作为一个参考

python 复制代码

import os

from django.core.asgi import get_asgi_application

os.environ.setdefault('DJANGO_SETTINGS_MODULE', '项目名称.settings')

# 原来的 application
django_asgi_app = get_asgi_application()

# ============
# 写一个 mcp 服务，内容也可以挪到其他位置，引入即可
from mcp.server.fastmcp import FastMCP
from asgiref.sync import sync_to_async

mcp1 = FastMCP("weather")

@mcp1.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"# Add an addition tool

@mcp1.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

mcp1.settings.mount_path = "/star" # 告诉 mcp server 将要处理 /star 路径下的内容
starlette_app = mcp1.sse_app()

# ============
# 对 application 进行引流
def application(scope, receive, send):
	
	# star 开头的服务全部交给 mcp1 处理
    if scope['path'].startwith('/star):
        scope['path'] = scope['path'].replace('/star', '', 1) # 记得把路径做个调整，不然会出错
        return starlette_app(scope, receive, send)
	# 其他交给 Django 处理
    return django_asgi_app(scope, receive, send)

第三步：Django 数据的异步查询

当我们定义一个 mcp 的工具，需要访问 Django 数据库时，初始化的部分需要注意：

如果 mcp 的服务就在 Django 的工程目录下，和 Django 一起完成了初始化，基本不需要做数据库和配置的处理
如果需要单独使用 Django 的数据库，可以参考之前的文章，完成配置。

由于 mcp 是 ASGI 服务，所以需要把所有的 Django 数据库查询调整为异步模式：

queryset 是惰性执行的，需要通过某些涉及数据库查询的函数才能触发执行
数据库查询的函数是同步的需要调整成异步函数

python 复制代码

# 假设我们定义了一个 Model 叫 Entry
from xxx import Entry
# 引入 sync_to_async
from asgiref.sync import sync_to_async


@mcp1.tool()
# 工具函数，需要定义为 async 函数，和 mcp1 放在同一个文件里
async def get_entry(tile: str):
    """Get the Entries"""
	# 方法一：async 循环
	async for e in Entry.objects.filter(title=name):
    	results.append(e.body)
		break
    return results

	# 方法二：通过 sync_to_async 函数，把同步函数异步执行
	q = Entry.objects.all()
	lc = sync_to_async(len)(q) # sync_to_async 会把函数变成一个 coroutine
	l = await lc # 等待 lc 执行
	results = q[0].body
    return results

	# 方法三，使用同步函数的异步版本，通常在同步函数前会增加 a，例如 aget、afirst
	q = await Entry.objects.afirst()
	results = q.body
    return results

如何在 Django 中集成 MCP Server

目录

背景说明

第一步：使用 ASGI

第二步：修改 asgi.py 中的应用

第三步：Django 数据的异步查询