Skip to content

Latest commit

 

History

History
400 lines (330 loc) · 14.9 KB

README.md

File metadata and controls

400 lines (330 loc) · 14.9 KB

🔧 الوحدة 3: تطوير MCP متقدم باستخدام مجموعة أدوات الذكاء الاصطناعي

المدة مجموعة أدوات الذكاء الاصطناعي بايثون MCP SDK المفتش

🎯 أهداف التعلم

بنهاية هذا المختبر، ستكون قادرًا على:

  • ✅ إنشاء خوادم MCP مخصصة باستخدام مجموعة أدوات الذكاء الاصطناعي
  • ✅ تكوين واستخدام أحدث إصدار من MCP Python SDK (الإصدار 1.9.3)
  • ✅ إعداد واستخدام MCP Inspector لأغراض التصحيح
  • ✅ تصحيح خوادم MCP في بيئتي Agent Builder وInspector
  • ✅ فهم سير عمل تطوير خوادم MCP المتقدمة

📋 المتطلبات الأساسية

  • إتمام مختبر 2 (أساسيات MCP)
  • تثبيت VS Code مع امتداد AI Toolkit
  • بيئة Python 3.10 أو أحدث
  • Node.js و npm لإعداد Inspector

🏗️ ما ستبنيه

في هذا المختبر، ستقوم بإنشاء خادم MCP للطقس يوضح:

  • تنفيذ خادم MCP مخصص
  • التكامل مع Agent Builder في مجموعة أدوات الذكاء الاصطناعي
  • سير عمل احترافي للتصحيح
  • أنماط استخدام حديثة لـ MCP SDK

🔧 نظرة عامة على المكونات الأساسية

🐍 MCP Python SDK

يوفر بروتوكول نموذج السياق (MCP) SDK لبايثون الأساس لبناء خوادم MCP مخصصة. ستستخدم الإصدار 1.9.3 مع ميزات تصحيح محسنة.

🔍 MCP Inspector

أداة تصحيح قوية توفر:

  • مراقبة الخادم في الوقت الحقيقي
  • تصور تنفيذ الأدوات
  • فحص طلبات واستجابات الشبكة
  • بيئة اختبار تفاعلية

📖 التنفيذ خطوة بخطوة

الخطوة 1: إنشاء WeatherAgent في Agent Builder

  1. افتح Agent Builder في VS Code عبر امتداد AI Toolkit
  2. أنشئ وكيلًا جديدًا بالتكوين التالي:
    • اسم الوكيل: WeatherAgent

إنشاء الوكيل

الخطوة 2: تهيئة مشروع خادم MCP

  1. اذهب إلى Tools → Add Tool في Agent Builder
  2. اختر "MCP Server" من الخيارات المتاحة
  3. اختر "Create A new MCP Server"
  4. اختر قالب python-weather
  5. سمِّ خادمك: weather_mcp

اختيار قالب بايثون

الخطوة 3: افتح وراجع المشروع

  1. افتح المشروع المُنشأ في VS Code
  2. راجع هيكل المشروع: 
    weather_mcp/
├── src/
│   ├── __init__.py
│   └── server.py
├── inspector/
│   ├── package.json
│   └── package-lock.json
├── .vscode/
│   ├── launch.json
│   └── tasks.json
├── pyproject.toml
└── README.md

الخطوة 4: الترقية إلى أحدث إصدار من MCP SDK

🔍 لماذا نُحدث؟ نرغب في استخدام أحدث إصدار من MCP SDK (الإصدار 1.9.3) وخدمة Inspector (الإصدار 0.14.0) للحصول على ميزات محسنة وقدرات تصحيح أفضل.

4أ. تحديث تبعيات بايثون

حرر pyproject.toml: تحديث ./code/weather_mcp/pyproject.toml

4ب. تحديث تكوين Inspector

حرر inspector/package.json: تحديث ./code/weather_mcp/inspector/package.json

4ج. تحديث تبعيات Inspector

حرر inspector/package-lock.json: تحديث ./code/weather_mcp/inspector/package-lock.json

📝 ملاحظة: يحتوي هذا الملف على تعريفات تبعيات واسعة النطاق. أدناه الهيكل الأساسي - المحتوى الكامل يضمن حل التبعيات بشكل صحيح.

⚡ ملف القفل الكامل: يحتوي package-lock.json الكامل على حوالي 3000 سطر من تعريفات التبعيات. ما سبق يعرض الهيكل الرئيسي - استخدم الملف المرفق لحل التبعيات بالكامل.

الخطوة 5: تكوين تصحيح الأخطاء في VS Code

ملاحظة: يرجى نسخ الملف في المسار المحدد لاستبدال الملف المحلي المقابل

5أ. تحديث تكوين الإطلاق

حرر .vscode/launch.json:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Attach to Local MCP",
      "type": "debugpy",
      "request": "attach",
      "connect": {
        "host": "localhost",
        "port": 5678
      },
      "presentation": {
        "hidden": true
      },
      "internalConsoleOptions": "neverOpen",
      "postDebugTask": "Terminate All Tasks"
    },
    {
      "name": "Launch Inspector (Edge)",
      "type": "msedge",
      "request": "launch",
      "url": "http://localhost:6274?timeout=60000&serverUrl=http://localhost:3001/sse#tools",
      "cascadeTerminateToConfigurations": [
        "Attach to Local MCP"
      ],
      "presentation": {
        "hidden": true
      },
      "internalConsoleOptions": "neverOpen"
    },
    {
      "name": "Launch Inspector (Chrome)",
      "type": "chrome",
      "request": "launch",
      "url": "http://localhost:6274?timeout=60000&serverUrl=http://localhost:3001/sse#tools",
      "cascadeTerminateToConfigurations": [
        "Attach to Local MCP"
      ],
      "presentation": {
        "hidden": true
      },
      "internalConsoleOptions": "neverOpen"
    }
  ],
  "compounds": [
    {
      "name": "Debug in Agent Builder",
      "configurations": [
        "Attach to Local MCP"
      ],
      "preLaunchTask": "Open Agent Builder",
    },
    {
      "name": "Debug in Inspector (Edge)",
      "configurations": [
        "Launch Inspector (Edge)",
        "Attach to Local MCP"
      ],
      "preLaunchTask": "Start MCP Inspector",
      "stopAll": true
    },
    {
      "name": "Debug in Inspector (Chrome)",
      "configurations": [
        "Launch Inspector (Chrome)",
        "Attach to Local MCP"
      ],
      "preLaunchTask": "Start MCP Inspector",
      "stopAll": true
    }
  ]
}

حرر .vscode/tasks.json:

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Start MCP Server",
      "type": "shell",
      "command": "python -m debugpy --listen 127.0.0.1:5678 src/__init__.py sse",
      "isBackground": true,
      "options": {
        "cwd": "${workspaceFolder}",
        "env": {
          "PORT": "3001"
        }
      },
      "problemMatcher": {
        "pattern": [
          {
            "regexp": "^.*$",
            "file": 0,
            "location": 1,
            "message": 2
          }
        ],
        "background": {
          "activeOnStart": true,
          "beginsPattern": ".*",
          "endsPattern": "Application startup complete|running"
        }
      }
    },
    {
      "label": "Start MCP Inspector",
      "type": "shell",
      "command": "npm run dev:inspector",
      "isBackground": true,
      "options": {
        "cwd": "${workspaceFolder}/inspector",
        "env": {
          "CLIENT_PORT": "6274",
          "SERVER_PORT": "6277",
        }
      },
      "problemMatcher": {
        "pattern": [
          {
            "regexp": "^.*$",
            "file": 0,
            "location": 1,
            "message": 2
          }
        ],
        "background": {
          "activeOnStart": true,
          "beginsPattern": "Starting MCP inspector",
          "endsPattern": "Proxy server listening on port"
        }
      },
      "dependsOn": [
        "Start MCP Server"
      ]
    },
    {
      "label": "Open Agent Builder",
      "type": "shell",
      "command": "echo ${input:openAgentBuilder}",
      "presentation": {
        "reveal": "never"
      },
      "dependsOn": [
        "Start MCP Server"
      ],
    },
    {
      "label": "Terminate All Tasks",
      "command": "echo ${input:terminate}",
      "type": "shell",
      "problemMatcher": []
    }
  ],
  "inputs": [
    {
      "id": "openAgentBuilder",
      "type": "command",
      "command": "ai-mlstudio.agentBuilder",
      "args": {
        "initialMCPs": [ "local-server-weather_mcp" ],
        "triggeredFrom": "vsc-tasks"
      }
    },
    {
      "id": "terminate",
      "type": "command",
      "command": "workbench.action.tasks.terminate",
      "args": "terminateAll"
    }
  ]
}

🚀 تشغيل واختبار خادم MCP الخاص بك

الخطوة 6: تثبيت التبعيات

بعد إجراء التعديلات، نفذ الأوامر التالية:

تثبيت تبعيات بايثون:

uv sync

تثبيت تبعيات Inspector:

cd inspector
npm install

الخطوة 7: التصحيح باستخدام Agent Builder

  1. اضغط F5 أو استخدم تكوين "Debug in Agent Builder"
  2. اختر التكوين المركب من لوحة التصحيح
  3. انتظر بدء تشغيل الخادم وفتح Agent Builder
  4. اختبر خادم MCP الخاص بالطقس باستخدام استعلامات اللغة الطبيعية

أدخل موجه مثل هذا

SYSTEM_PROMPT

You are my weather assistant

USER_PROMPT

How's the weather like in Seattle

نتيجة تصحيح Agent Builder

الخطوة 8: التصحيح باستخدام MCP Inspector

  1. استخدم تكوين "Debug in Inspector" (Edge أو Chrome)
  2. افتح واجهة Inspector على http://localhost:6274
  3. استكشف بيئة الاختبار التفاعلية:
    • عرض الأدوات المتاحة
    • اختبار تنفيذ الأدوات
    • مراقبة طلبات الشبكة
    • تصحيح استجابات الخادم

واجهة MCP Inspector

🎯 النتائج الرئيسية للتعلم

بإكمال هذا المختبر، تكون قد:

  • أنشأت خادم MCP مخصص باستخدام قوالب AI Toolkit
  • قمت بالترقية إلى أحدث إصدار من MCP SDK (الإصدار 1.9.3) لتحسين الوظائف
  • كونت سير عمل تصحيح احترافي لكل من Agent Builder وInspector
  • أعددت MCP Inspector لاختبار الخادم بشكل تفاعلي
  • أتقنت تكوينات تصحيح الأخطاء في VS Code لتطوير MCP

🔧 الميزات المتقدمة التي تم استكشافها

الميزة الوصف حالة الاستخدام
MCP Python SDK v1.9.3 أحدث تنفيذ للبروتوكول تطوير خوادم حديثة
MCP Inspector 0.14.0 أداة تصحيح تفاعلية اختبار الخادم في الوقت الحقيقي
تصحيح VS Code بيئة تطوير متكاملة سير عمل تصحيح احترافي
تكامل Agent Builder اتصال مباشر مع AI Toolkit اختبار الوكلاء من البداية للنهاية

📚 موارد إضافية

🎉 تهانينا! لقد أكملت بنجاح المختبر 3 وأصبحت الآن قادرًا على إنشاء وتصحيح ونشر خوادم MCP مخصصة باستخدام سير عمل تطوير احترافي.

🔜 تابع إلى الوحدة التالية

هل أنت مستعد لتطبيق مهارات MCP في سير عمل تطوير حقيقي؟ تابع إلى الوحدة 4: تطوير MCP عملي - خادم استنساخ GitHub مخصص حيث ستقوم بـ:

  • بناء خادم MCP جاهز للإنتاج لأتمتة عمليات مستودعات GitHub
  • تنفيذ وظيفة استنساخ مستودعات GitHub عبر MCP
  • دمج خوادم MCP المخصصة مع VS Code ووضع GitHub Copilot Agent
  • اختبار ونشر خوادم MCP المخصصة في بيئات الإنتاج
  • تعلم أتمتة سير العمل العملية للمطورين

إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق به. للمعلومات الهامة، يُنصح بالترجمة البشرية المهنية. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.