ابدأ في بناء الخادم الخاص بك لاستخدامه في Claude for Desktop وعملاء آخرين.في هذا البرنامج التعليمي، سنقوم ببناء خادم طقس MCP بسيط وتوصيله بمضيف، Claude for Desktop. سنبدأ بإعداد أساسي، ثم ننتقل إلى حالات استخدام أكثر تعقيدًا.العديد من نماذج اللغات الكبيرة (بما في ذلك Claude) لا تملك حاليًا القدرة على جلب التوقعات وتنبيهات الطقس القاسي. دعنا نستخدم MCP لحل ذلك!سنقوم ببناء خادم يعرض أداتين: get-alerts
و get-forecast
. ثم سنقوم بتوصيل الخادم بمضيف MCP (في هذه الحالة، Claude for Desktop):لماذا Claude for Desktop وليس Claude.ai؟يمكن لخوادم MCP توفير ثلاثة أنواع رئيسية من القدرات:1.
الموارد: بيانات شبيهة بالملفات يمكن قراءتها بواسطة العملاء (مثل استجابات واجهة برمجة التطبيقات أو محتويات الملفات)
2.
الأدوات: وظائف يمكن استدعاؤها بواسطة نموذج اللغة الكبير (بموافقة المستخدم)
3.
المطالبات: قوالب مكتوبة مسبقًا تساعد المستخدمين على إنجاز مهام محددة
سيركز هذا البرنامج التعليمي بشكل أساسي على الأدوات.المعرفة المسبقة#
يفترض هذا البدء السريع أن لديك معرفة بـ:نماذج اللغات الكبيرة مثل Claude
متطلبات النظام#
بايثون 3.10 أو أعلى مثبتة.
يجب عليك استخدام Python MCP SDK 1.2.0 أو أعلى.
إعداد بيئتك#
أولاً، لنقم بتثبيت uv
وإعداد مشروع وبيئة بايثون الخاصة بنا:powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
تأكد من إعادة تشغيل جهازك بعد ذلك للتأكد من التقاط أمر uv
.الآن، لنقم بإنشاء وإعداد مشروعنا:
uv init weather
cd weather
uv venv
.venv\Scripts\activate
uv add mcp[cli] httpx
new-item weather.py
uv init weather
cd weather
uv venv
.venv\Scripts\activate
uv add mcp[cli] httpx
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 مثبتًا:code $env:AppData\Claude\claude_desktop_config.json
ستضيف بعد ذلك الخوادم الخاصة بك في مفتاح mcpServers
. ستظهر عناصر واجهة مستخدم MCP فقط في Claude for Desktop إذا تم تكوين خادم واحد على الأقل بشكل صحيح.في هذه الحالة، سنضيف خادم الطقس الفردي الخاص بنا على النحو التالي:{
"mcpServers": {
"weather": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
"run",
"weather.py"
]
}
}
}
{
"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
الخاص بنا. يمكنك القيام بذلك عن طريق البحث عن رمز المطرقة
:بعد النقر فوق رمز المطرقة، يجب أن ترى أداتين مدرجتين:إذا لم يتم التقاط الخادم الخاص بك بواسطة Claude for Desktop، فانتقل إلى قسم استكشاف الأخطاء وإصلاحها للحصول على نصائح حول تصحيح الأخطاء.إذا ظهر رمز المطرقة، يمكنك الآن اختبار الخادم الخاص بك عن طريق تشغيل الأوامر التالية في Claude for Desktop:ما هي تنبيهات الطقس النشطة في تكساس؟
نظرًا لأن هذه هي خدمة الأرصاد الجوية الوطنية الأمريكية، فإن الاستعلامات ستعمل فقط للمواقع الأمريكية.1.
يرسل العميل سؤالك إلى Claude
2.
يقوم Claude بتحليل الأدوات المتاحة ويقرر أي منها سيستخدم
3.
يقوم العميل بتنفيذ الأدوات المختارة من خلال خادم MCP
4.
يتم إرسال النتائج مرة أخرى إلى Claude
5.
يقوم Claude بصياغة استجابة لغة طبيعية
Modified at 2025-03-12 10:28:55