وثائق MCP الرسمية باللغة العربية
  1. البدء السريع
وثائق MCP الرسمية باللغة العربية
  • البدء
    • مقدمة
    • خوادم المثال
    • أمثلة على العملاء
    • البدء السريع
      • لمطوري الخوادم
      • للمطورين العملاء
      • لمستخدمي سطح مكتب كلود
  • دروس تعليمية
    • LLMs بناء MCP مع
    • تصحيح الأخطاء
    • مفتش
  • المفاهيم
    • الهندسة المعمارية الأساسية
    • موارد
    • المطالبات
    • أدوات
    • أخذ العينات
    • الجذور
    • وسائل النقل
  • تطوير
    • ما الجديد
    • خريطة الطريق
    • المساهمة
  1. البدء السريع

لمطوري الخوادم

ابدأ في بناء الخادم الخاص بك لاستخدامه في Claude for Desktop وعملاء آخرين.
في هذا البرنامج التعليمي، سنقوم ببناء خادم طقس MCP بسيط وتوصيله بمضيف، Claude for Desktop. سنبدأ بإعداد أساسي، ثم ننتقل إلى حالات استخدام أكثر تعقيدًا.

ما الذي سنقوم ببنائه#

العديد من نماذج اللغات الكبيرة (بما في ذلك Claude) لا تملك حاليًا القدرة على جلب التوقعات وتنبيهات الطقس القاسي. دعنا نستخدم MCP لحل ذلك!
سنقوم ببناء خادم يعرض أداتين: get-alerts و get-forecast. ثم سنقوم بتوصيل الخادم بمضيف MCP (في هذه الحالة، Claude for Desktop):
img
img
يمكن للخوادم الاتصال بأي عميل. لقد اخترنا Claude for Desktop هنا للتبسيط، ولكن لدينا أيضًا أدلة حول بناء العميل الخاص بك بالإضافة إلى قائمة بالعملاء الآخرين هنا.
لماذا Claude for Desktop وليس Claude.ai؟

المفاهيم الأساسية لـ MCP#

يمكن لخوادم MCP توفير ثلاثة أنواع رئيسية من القدرات:
1.
الموارد: بيانات شبيهة بالملفات يمكن قراءتها بواسطة العملاء (مثل استجابات واجهة برمجة التطبيقات أو محتويات الملفات)
2.
الأدوات: وظائف يمكن استدعاؤها بواسطة نموذج اللغة الكبير (بموافقة المستخدم)
3.
المطالبات: قوالب مكتوبة مسبقًا تساعد المستخدمين على إنجاز مهام محددة
سيركز هذا البرنامج التعليمي بشكل أساسي على الأدوات.
بايثون
لنبدأ ببناء خادم الطقس الخاص بنا! يمكنك العثور على الكود الكامل لما سنقوم ببنائه هنا.

المعرفة المسبقة#

يفترض هذا البدء السريع أن لديك معرفة بـ:
بايثون
نماذج اللغات الكبيرة مثل Claude

متطلبات النظام#

بايثون 3.10 أو أعلى مثبتة.
يجب عليك استخدام Python MCP SDK 1.2.0 أو أعلى.

إعداد بيئتك#

أولاً، لنقم بتثبيت uv وإعداد مشروع وبيئة بايثون الخاصة بنا:
MacOS/Linux
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
تأكد من إعادة تشغيل جهازك بعد ذلك للتأكد من التقاط أمر uv.
الآن، لنقم بإنشاء وإعداد مشروعنا:
MacOS/Linux
# Create a new directory for our project
uv init weather
cd weather

# Create virtual environment and activate it
uv venv
.venv\Scripts\activate

# Install dependencies
uv add mcp[cli] httpx

# Create our server file
new-item weather.py
Windows
# Create a new directory for our project
uv init weather
cd weather

# Create virtual environment and activate it
uv venv
.venv\Scripts\activate

# Install dependencies
uv add mcp[cli] httpx

# Create our server file
new-item weather.py
الآن دعنا نتعمق في بناء الخادم الخاص بك.

بناء الخادم الخاص بك#

استيراد الحزم وإعداد المثيل#

أضف هذه إلى أعلى weather.py:
يستخدم فئة FastMCP تلميحات أنواع بايثون وسلاسل التوثيق لإنشاء تعريفات الأدوات تلقائيًا، مما يجعل من السهل إنشاء أدوات MCP وصيانتها.

وظائف المساعدة#

بعد ذلك، لنضف وظائف المساعدة الخاصة بنا للاستعلام عن البيانات وتنسيقها من واجهة برمجة تطبيقات خدمة الأرصاد الجوية الوطنية:

تنفيذ أداة التنفيذ#

معالج تنفيذ الأداة مسؤول عن التنفيذ الفعلي لمنطق كل أداة. لنضفه:

تشغيل الخادم#

أخيرًا، لنقم بتهيئة وتشغيل الخادم:
الخادم الخاص بك كامل! قم بتشغيل uv run weather.py للتأكد من أن كل شيء يعمل.
لنختبر الآن الخادم الخاص بك من مضيف MCP موجود، Claude for Desktop.

اختبار الخادم الخاص بك باستخدام Claude for Desktop#

Claude for Desktop غير متاح بعد على Linux. يمكن لمستخدمي Linux المتابعة إلى البرنامج التعليمي بناء عميل لبناء عميل MCP يتصل بالخادم الذي قمنا ببنائه للتو.
أولاً، تأكد من تثبيت Claude for Desktop. يمكنك تثبيت أحدث إصدار هنا. إذا كان لديك بالفعل Claude for Desktop، فتأكد من تحديثه إلى أحدث إصدار.
سنحتاج إلى تكوين Claude for Desktop لأي خوادم MCP تريد استخدامها. للقيام بذلك، افتح تكوين تطبيق Claude for Desktop الخاص بك على ~/Library/Application Support/Claude/claude_desktop_config.json في محرر نصوص. تأكد من إنشاء الملف إذا لم يكن موجودًا.
على سبيل المثال، إذا كان لديك VS Code مثبتًا:
MacOS/Linux
Windows
code $env:AppData\Claude\claude_desktop_config.json
ستضيف بعد ذلك الخوادم الخاصة بك في مفتاح mcpServers. ستظهر عناصر واجهة مستخدم MCP فقط في Claude for Desktop إذا تم تكوين خادم واحد على الأقل بشكل صحيح.
في هذه الحالة، سنضيف خادم الطقس الفردي الخاص بنا على النحو التالي:
MacOS/Linux
{
    "mcpServers": {
        "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "weather.py"
            ]
        }
    }
}
Windows
{
    "mcpServers": {
        "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\weather",
                "run",
                "weather.py"
            ]
        }
    }
}
قد تحتاج إلى وضع المسار الكامل إلى ملف uv القابل للتنفيذ في حقل command. يمكنك الحصول على هذا عن طريق تشغيل which uv على MacOS/Linux أو where uv على Windows.
تأكد من تمرير المسار المطلق إلى الخادم الخاص بك.
هذا يخبر Claude for Desktop:
1.
يوجد خادم MCP باسم "weather"
2.
لتشغيله عن طريق تشغيل uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather run weather.py
احفظ الملف، وأعد تشغيل Claude for Desktop.

الاختبار بالأوامر#

دعنا نتأكد من أن Claude for Desktop يلتقط الأداتين اللتين عرضناهما في خادم weather الخاص بنا. يمكنك القيام بذلك عن طريق البحث عن رمز المطرقة img:
img
بعد النقر فوق رمز المطرقة، يجب أن ترى أداتين مدرجتين:
img
إذا لم يتم التقاط الخادم الخاص بك بواسطة Claude for Desktop، فانتقل إلى قسم استكشاف الأخطاء وإصلاحها للحصول على نصائح حول تصحيح الأخطاء.
إذا ظهر رمز المطرقة، يمكنك الآن اختبار الخادم الخاص بك عن طريق تشغيل الأوامر التالية في Claude for Desktop:
ما هو الطقس في سكرامنتو؟
ما هي تنبيهات الطقس النشطة في تكساس؟
img
img
نظرًا لأن هذه هي خدمة الأرصاد الجوية الوطنية الأمريكية، فإن الاستعلامات ستعمل فقط للمواقع الأمريكية.

ماذا يحدث تحت الغطاء#

عندما تطرح سؤالاً:
1.
يرسل العميل سؤالك إلى Claude
2.
يقوم Claude بتحليل الأدوات المتاحة ويقرر أي منها سيستخدم
3.
يقوم العميل بتنفيذ الأدوات المختارة من خلال خادم MCP
4.
يتم إرسال النتائج مرة أخرى إلى Claude
5.
يقوم Claude بصياغة استجابة لغة طبيعية
6.
يتم عرض الاستجابة لك!
Modified at 2025-03-12 10:28:55
Previous
أمثلة على العملاء
Next
للمطورين العملاء
Built with