MCP: اكتب خادمًا وصله
بعد قراءة هذا القسم، ستكتب خادم MCP خاصًا بك، وتجعل myagent يتصل به ويكتشف أدواته ويستدعيها. وستفهم أيضًا المشكلة التي يحلها MCP بالضبط.
لننظر أولًا إلى المشكلة: إعادة كتابة كل أداة عند كل توصيل
في الفصل السابق، كتبنا الأدوات داخل agent.py. لكن إذا أردت أن تستطيع Claude Code وCursor ووكيلك الخاص جميعها البحث في مكتبة ملاحظات الشركة، فعليك كتابتها ثلاث مرات في ثلاثة أماكن، وبصيغ مختلفة لكل منها.
وُجد MCP (Model Context Protocol، بروتوكول سياق النموذج) لحل هذه المشكلة: اكتب الأداة مرة واحدة، واجعلها خادم MCP، فتستطيع كل البرامج الداعمة لـ MCP استخدامها مباشرة. التشبيه الرسمي هو: MCP مثل منفذ USB-C لتطبيقات الذكاء الاصطناعي.
ثلاثة أدوار
ابحثداخل MCP...
انقر على واحد لترى.
يمكن للخادم تقديم ثلاثة أنواع من الأشياء: Tools (دوال يقرر النموذج متى يستدعيها)، Resources (بيانات يقرأها التطبيق)، Prompts (قوالب مطالبات يختارها المستخدم). يستخدم هذا القسم Tools فقط. صيغة الرسائل هي JSON-RPC 2.0؛ وهكذا تبدو استدعاء أداة واحد على الشبكة (من نص المواصفات):
{ "jsonrpc": "2.0", "id": 2, "method": "tools/call",
"params": { "name": "get_weather", "arguments": { "location": "New York" } } }1. اكتب خادم MCP
mcp_servers/notes_server.py (داخل myagent.zip):
import json
from pathlib import Path
from mcp.server import MCPServer
NOTES = Path(__file__).with_name("notes.json")
mcp = MCPServer("notes")
def _load():
return json.loads(NOTES.read_text(encoding="utf-8")) if NOTES.exists() else []
@mcp.tool()
def add_note(text: str) -> str:
"""记下一条笔记。"""
notes = _load() + [text]
NOTES.write_text(json.dumps(notes, ensure_ascii=False), encoding="utf-8")
return f"已记下,共 {len(notes)} 条。"
@mcp.tool()
def search_notes(keyword: str) -> list[str]:
"""按关键词查找笔记,返回所有包含这个词的笔记。"""
return [n for n in _load() if keyword in n]
if __name__ == "__main__":
mcp.run()على عكس الفصل السابق حيث كتبنا JSON Schema يدويًا، هنا تعليقات الأنواع هي الـ schema: text: str يخبر الحزمة أن المعامل نص، وسلسلة توثيق الدالة هي وصف الأداة. mcp.run() بدون معاملات، أي أنها تتواصل مع العميل عبر stdio (الإدخال/الإخراج القياسي).
::: تحذير: FastMCP الموجود في الكثير من الدروس على الإنترنت لم يعد يعمل في النسخة الجديدة منذ النسخة 2.x، أعادت حزمة Python SDK الرسمية تسمية FastMCP إلى MCPServer، وحُذفت مسارات الاستيراد القديمة مباشرة. إذا كتبت from mcp.server.fastmcp import FastMCP كما في الدروس القديمة، ستحصل على ModuleNotFoundError: No module named 'mcp.server.fastmcp'، وستقترح رسالة الخطأ استخدام from mcp.server.mcpserver import MCPServer بدلًا منه. نحن نستخدم mcp 2.3.0 (صدر في 2026-10-02). إذا أردت تشغيل الكود القديم، فثبّت mcp<2. :::
2. اجعل الوكيل يتصل به
في MCP SDK 2.x، لا يوجد في جهة العميل سوى فئة Client واحدة. أعطها StdioServerParameters وستقوم بتشغيل الخادم كعملية فرعية والاتصال به عبر stdio:
async def connect_mcp(command, stack):
from mcp import Client
from mcp.client.stdio import StdioServerParameters
parts = shlex.split(command)
mcp_client = await stack.enter_async_context(Client(StdioServerParameters(command=parts[0], args=parts[1:])))
listed = await mcp_client.list_tools()
tools = [{"type": "function", "function": {"name": t.name, "description": t.description or "",
"parameters": t.input_schema}} for t in listed.tools]
return mcp_client, toolsالخطوة الأساسية: تحويل الأدوات التي يسردُها خادم MCP (الاسم، الوصف، مخطط الإدخال) إلى صيغة tools التي يفهمها النموذج، ودمجها مع الأدوات المحلية وتسليمها للنموذج. وعندما يطلب النموذج استدعاء أداة ليست محلية، تُحوَّل إلى MCP:
r = await mcp_client.call_tool(name, args)
result = "\n".join(getattr(c, "text", str(c)) for c in r.content)التشغيل:
python agent.py --mcp "python mcp_servers/notes_server.py" "记一条笔记:周五下午三点和设计组评审消息通知的交互稿"
python agent.py --mcp "python mcp_servers/notes_server.py" "我记过哪些和设计组有关的事?"يفترض أن ترى (مخرجات حقيقية من qwen3:8b على هذا الجهاز):
تم الاتصال بخادم MCP، أدوات جديدة: add_note, search_notes
[1] add_note({"text": "مراجعة مسودة تفاعلية لإشعارات الرسائل مع فريق التصميم يوم الجمعة الساعة الثالثة عصرًا"})
الوكيل: تم تسجيل الملاحظة: مراجعة مسودة تفاعلية لإشعارات الرسائل مع فريق التصميم يوم الجمعة الساعة الثالثة عصرًا.تم الاتصال بخادم MCP، أدوات جديدة: add_note, search_notes
[1] search_notes({"keyword": "فريق التصميم"})
الوكيل: عُثر على الملاحظات التالية المتعلقة بفريق التصميم:
- مراجعة مسودة تفاعلية لإشعارات الرسائل مع فريق التصميم يوم الجمعة الساعة الثالثة عصرًالا يوجد في كود myagent سطر واحد يتعلق بالملاحظات؛ فجميع الأدوات تأتي من خادم MCP. ويمكن أيضًا تهيئة notes_server.py نفسه لبرامج أخرى تدعم MCP مثل Claude Code.
فخ سهل الوقوع فيه: العملية الفرعية للخادم المُطلقة عبر stdio لا ترث كل متغيرات بيئتك، بل عددًا قليلًا فقط مثل HOME وPATH. إذا احتاج الخادم إلى مفتاح API، فيجب تمريره صراحةً داخل StdioServerParameters(env={...}).
3. ما الذي تغيّر في الإصدار الجديد من المواصفة
رقم إصدار MCP عبارة عن تاريخ يشير إلى آخر تعديل غير متوافق مع الإصدارات السابقة. الإصدار الحالي هو 2026-07-28، والإصدار السابق هو 2025-11-25. هذا الإصدار يحتوي على تغييرات كبيرة:
- أصبحت البروتوكول عديمة الحالة: حُذفت المصافحة
initialize، وأصبح كل طلب يحمل معه معلومات الإصدار والقدرات؛ وأُضيفserver/discoverكأمر يجب تنفيذه. - لم يعد Streamable HTTP يحتوي على معرّف جلسة.
- تم وضع علامة "مهمل" على ثلاث ميزات: Roots وSampling وLogging.
لذلك فإن الدروس المتوفرة على الإنترنت التي تتحدث عن "المصافحة initialize أولاً" تشير إلى الإصدار القديم. عند كتابة الكود باستخدام SDK لن تشعر بهذه التغييرات تقريبًا، إذ يتولى SDK التعامل معها نيابةً عنك.
أصبح MCP الآن أحد مشاريع مؤسسة Agentic AI Foundation (AAIF) التابعة لمؤسسة Linux.
4. الأمان: أدوات MCP هي ببساطة كود أشخاص آخرين
المواصفة تنص بوضوح: الأداة تعني تنفيذ كود عشوائي، ويجب على المضيف الحصول على موافقة صريحة من المستخدم قبل استدعاء أي أداة؛ وأوصاف الأدوات يجب اعتبارها غير موثوقة ما لم تأتِ من خادم موثوق. اتصل فقط بخوادم MCP التي تثق بها. لم يقم myagent لدينا، من أجل البساطة، بإضافة تأكيد لأدوات MCP، وسيتم شرح كيفية إضافته في الفصل الأخير.
اختبر معرفتكما المشكلة الجوهرية التي يحلها MCP؟
تحقق من ذلك
- كتبت notes_server.py وجعلت myagent يتصل عبر
--mcp - أعرف أن FastMCP تمت إعادة تسميته إلى MCPServer في الإصدار 2.x من SDK
- أستطيع ذكر أكبر التغييرات في مواصفة الإصدار 2026-07-28
القسم التالي: الفرق بين MCP وFunction Calling وA2A وSkills.