WebMCP مع Django وFastAPI: أدوات وكلاء الذكاء الاصطناعي لتطبيقات Python

لا تحتاج تطبيقات الويب المبنية بـ Python إلا إلى القليل لدعم WebMCP. تعمل الأداة في المتصفح ببضعة أسطر من JavaScript، ويقوم تطبيق Django أو FastAPI بالعمل الحقيقي خلفها. جديد على الموضوع؟ ابدأ بمقال ما هو WebMCP.

نقطة نهاية في FastAPI

يوقف التحقق من الاستعلام المدخلات السيئة قبل تشغيل الكود، ويحدّد نموذج الاستجابة ما يخرج من الخادم:

from fastapi import APIRouter, Query
from pydantic import BaseModel

router = APIRouter()

class ProductOut(BaseModel):
    name: str
    price: float
    url: str

@router.get('/agent/products', response_model=list[ProductOut])
async def search_products(q: str = Query(min_length=1, max_length=80)):
    return await search_catalog(q, limit=5)  # your own function

عرض (view) في Django

from django.http import JsonResponse
from django.views.decorators.http import require_GET

from .models import Product

@require_GET
def agent_products(request):
    q = request.GET.get('q', '').strip()[:80]
    if not q:
        return JsonResponse({'error': 'missing_query'}, status=400)
    items = Product.objects.filter(published=True, name__icontains=q)[:5]
    return JsonResponse(list(items.values('name', 'price', 'slug')), safe=False)

أضف أيضًا حدًّا لمعدّل الطلبات، مثلًا على مستوى الوكيل العكسي (proxy) أو بأدوات التحديد في إطار العمل لديك.

سكربت المتصفح

حمّل هذا السكربت من القالب الأساسي أو من الواجهة الأمامية:

const mc = document.modelContext || navigator.modelContext;
if (mc && mc.registerTool) {
  mc.registerTool({
    name: 'search_products',
    description: 'Search published products. Returns name, price and link.',
    inputSchema: {
      type: 'object',
      properties: { q: { type: 'string', description: 'Keywords' } },
      required: ['q'],
    },
    annotations: { readOnlyHint: true },
    execute: async ({ q }) => {
      const res = await fetch('/agent/products?q=' + encodeURIComponent(q));
      return await res.text();
    },
  });
}

الجلسات وCSRF والصلاحيات

تعمل الأدوات داخل الصفحة، لذا تحمل الطلبات من الأصل نفسه ملفات تعريف الارتباط الخاصة بالزائر، ويعمل login_required أو اعتماديات FastAPI كالمعتاد. وفي أدوات POST في Django، أرسل ملف تعريف الارتباط csrftoken في ترويسة X-CSRFToken، وميّز الأداة بـ consequentialHint: true.

قواعد الأمان

• ابدأ بالقراءة فقط. البحث والتفاصيل أولًا، وميّزها بـ readOnlyHint.
• اسأل قبل التنفيذ. ميّز إجراءات السلة والحجز والنماذج بـ consequentialHint ليؤكّدها الزائر.
• تحقّق على الخادم. المتصفح ليس حدًّا أمنيًّا، لذا تحقّق من كل مدخل وكل صلاحية في الواجهة الخلفية.
• أعِد أقل قدر ممكن. أرسل فقط ما يحق للعميل رؤيته، ولا ترسل أبدًا بيانات الإدارة أو سجلات عملاء آخرين.

اختبر الأدوات

1. استخدم إصدارًا حديثًا من Chrome مع تفعيل WebMCP، عبر التجربة الأولية (origin trial) أو إعداد الاختبار.
2. استدعِ كل أداة بمدخلات صحيحة وأخرى خاطئة.
3. تأكّد من أن الزوار العاديين لا يلاحظون أي تغيير.
4. شغّل فاحص WebMCP المجاني على الصفحة نفسها التي توجد فيها أدواتك.

متى يكون خادم MCP الخيار الأنسب

إذا أردت أن تستخدم تطبيقات الذكاء الاصطناعي بياناتك من دون فتح موقعك، فابنِ خادم MCP بدلًا من ذلك. اطّلع على WebMCP مقابل MCP وخدمة تطوير خوادم MCP. ولجانب المتصفح، اطّلع على خدمات دمج WebMCP.