
MCP with Claude
Model Context Protocol with Claude
Unlock the power of Claude by connecting it to your files, tools, and data securely.
What you'll learn
- Understand the Model Context Protocol and its necessity for Claude.
- Build and configure your first server using Claude Desktop.
- Implement file and Git servers that interact with Claude.
- Create a database server that retains information across sessions.
- Develop a server that communicates with a web service securely.
- Test and validate your servers using Python and pytest.
About this book
This practical professional book by Ahmed Hassan Khamis is designed for developers and programmers who want to master the Model Context Protocol (MCP) with Claude. Spanning 400 full-color pages, it provides a comprehensive guide to understanding how hosts, clients, and servers communicate, along with the tools and resources needed to build your own MCP servers in Python.
Each chapter is filled with hands-on labs, ready-to-use code, exercises, and summaries, ensuring that readers can apply what they learn immediately. With three full projects included—a database server, a company documents and knowledge server, and a server that interacts with a web service—this book equips you with the skills to implement real-world solutions using Claude and Python.
Who this book is for
- developers
- programmers
- data and automation specialists
- technical teams
Why read this book
- Comprehensive hands-on labs and exercises in every chapter.
- Three complete projects that provide practical experience.
- Full-color illustrations and easy-to-follow instructions.
- Focus on security and best practices for server communication.
Reader reviews
Table of contents
1المقدمة
- لمن هذا الكتاب
- باب محكوم لكلود
- خريطة الكتاب
- كيف تقرأ كل فصل
- ما تحتاجه قبل أن تبدأ
- الأسماء وهمية والأدوات تتغير
2لماذا يحتاج كلود إلى MCP
- سارة تنسخ وتلصق
- ما الذي يعرفه النموذج وما الذي لا يعرفه
- مشكلة كل برنامج مع كل أداة
- معيار مفتوح واحد
- ثلاثة أطراف
- جربها بنفسك
- ماذا ستبني في هذا الكتاب
- تمارين الفصل
- حلول التمارين
3المضيف والعميل والسيرفر وكيف يتكلمون
- مكالمة لها بداية
- الأطراف الثلاثة بالتفصيل
- لغة الرسائل
- التعارف أولا
- طريقة الكلام بين البرنامجين
- نهاية الاتصال
- تمارين الفصل
- حلول التمارين
4الأدوات والموارد وقوالب الرسائل
- مطعم فيه قائمة ومطبخ ونادل
- الأدوات: كلود يفعل شيئا
- الموارد: كلود يقرأ شيئا
- قوالب الرسائل: المستخدم يختار
- ما يقدمه العميل للسيرفر
- أيها تختار
- تمارين الفصل
- حلول التمارين
5طرق النقل: stdio و HTTP
- الهاتف الداخلي والبريد
- stdio من الداخل
- HTTP القابل للبث
- الطريقة القديمة
- متى تختار هذه أو تلك
- تمارين الفصل
- حلول التمارين
6رحلة رسالة من كلود إلى السيرفر وعودتها
- طلب في مطعم من أوله لآخره
- كلود يقرر أن يستعمل أداة
- استدعاء الأداة ونتيجتها
- كلود يكتب الجواب
- اقرأ سجل البروتوكول
- تمارين الفصل
- حلول التمارين
7Claude Desktop: ملف الإعداد وأول سيرفر
- باب له مفتاح
- أين ملف الإعداد
- شكل الملف
- متغيرات البيئة في الإعداد
- امتداد سطح المكتب
- لم يظهر السيرفر
- تمارين الفصل
- حلول التمارين
8Claude Code وأوامر claude mcp
- نفس الباب من غرفة أخرى
- إضافة سيرفر بأمر واحد
- لمن هذا الإعداد
- القائمة والتفاصيل والحذف
- داخل الجلسة
- أول طلب
- تمارين الفصل
- حلول التمارين
9سيرفر الملفات
- مفتاح غرفة واحدة لا مفتاح البيت
- سيرفر الملفات الرسمي
- المجلد المسموح
- القراءة والكتابة والبحث
- ملفات الواحة مع كلود
- متى لا تستعمله
- تمارين الفصل
- حلول التمارين
10سيرفر Git وسيرفر الجلب من الويب
- دفتر يحفظ كل تعديل
- سيرفر Git
- سيرفر الجلب
- صفحة من داخل المعمل
- كلود يقرأ تاريخ المشروع
- حدود الجلب
- تمارين الفصل
- حلول التمارين
11قاعدة البيانات وسيرفر الذاكرة
- جدول الطلبات
- سيرفر جاهز لقاعدة بيانات
- كلود يسأل الجداول
- لماذا القراءة فقط
- سيرفر الذاكرة
- كلود يتذكر بين الجلسات
- تمارين الفصل
- حلول التمارين
12المتصفح: كلود يفتح الصفحات وينقر
- مساعد يجلس أمام شاشتك
- سيرفر Playwright
- كيف يرى كلود الصفحة
- املأ نموذجا
- حدود وأخطار
- تمارين الفصل
- حلول التمارين
13الموصلات البعيدة والصلاحيات والأمان
- من تعطيه مفتاح المخزن
- الموصل البعيد
- الصلاحيات في Claude Code
- حقن التعليمات
- تسميم الأداة
- قواعد عمر
- تمارين الفصل
- حلول التمارين
14أول سيرفر ببايثون
- ما تحتاجه من بايثون في هذا الكتاب
- مشروع جديد بـ uv
- ستة أسطر تصنع سيرفرا
- جربه في أداة الفحص
- اقرأ ما صنعته الحزمة
- لم يشتغل
- تمارين الفصل
- حلول التمارين
15الأدوات: المدخلات والمخرجات والأنواع
- نموذج طلب بخانات
- تلميح النوع يصنع الوصف
- مدخلات مركبة
- مخرجات منظمة
- صورة بدل النص
- تلميحات الأداة
- تمارين الفصل
- حلول التمارين
16الموارد وقوالب الموارد
- رف الكتب في المكتبة
- مورد ثابت
- شكل المعرف
- قالب مورد للمنتجات
- نوع المحتوى
- من يقرأ الموارد
- تمارين الفصل
- حلول التمارين
17قوالب الرسائل
- وصفة جاهزة
- أول قالب
- رسائل متعددة
- قالب يحمل موردا
- الإكمال التلقائي للوسائط
- قوالب لفريق الواحة
- تمارين الفصل
- حلول التمارين
18السياق: التقدم والسجل وطلب معلومة
- سائق يخبرك أين وصل
- كائن السياق
- السجل ومستوياته
- إشعار التقدم
- اسأل المستخدم
- موارد تبقى طول عمر السيرفر
- تمارين الفصل
- حلول التمارين
19الأخطاء والتحقق من المدخلات
- موظف يقول لا أعرف بدل أن يخترع
- نوعان من الأخطاء
- التحقق من المدخلات
- رسالة خطأ تساعد كلود
- مهلة الانتظار
- فخ stdio الأكبر
- تمارين الفصل
- حلول التمارين
20الاختبار بالكود: عميل بايثون و pytest
- فحص السيارة قبل السفر
- عميل بايثون صغير
- أول اختبار
- اختبار في الذاكرة بلا تشغيل برنامج
- ماذا تختبر
- تمارين الفصل
- حلول التمارين
21التوصيل بكلود والنقل عبر HTTP
- اليوم الأول للموظف الجديد
- سيرفرك في Claude Code
- سيرفرك في Claude Desktop
- سيرفرك عبر HTTP
- السيرفر عديم الحالة
- كريم يستعمل سيرفر سارة
- تمارين الفصل
- حلول التمارين
22مشروع: سيرفر قاعدة بيانات الواحة
- ما يريده كريم بالضبط
- تصميم الأدوات قبل الكود
- الاستعلام المعلمي
- وضع القراءة فقط
- موارد للجداول
- كريم يسأل
- تمارين الفصل
- حلول التمارين
23مشروع: سيرفر مستندات الشركة ومعرفتها
- موظف جديد يسأل عن الإجازات
- مستندات منى
- أداة بحث
- كل مستند مورد
- قالب: لخص سياسة
- كلود يجيب بالمصدر
- تمارين الفصل
- حلول التمارين
24مشروع: سيرفر يتكلم مع خدمة ويب
- نبيل يتصل بشركة الشحن كل ساعة
- الواجهة البرمجية لشركة الشحن السريع
- عميل غير متزامن
- مهلة وإعادة محاولة
- حد المعدل
- نبيل يسأل عن شحنة
- تمارين الفصل
- حلول التمارين
25الحماية والمصادقة بالرموز
- بطاقة الدخول إلى المبنى
- من يصدر البطاقة ومن يفحصها
- رمز الوصول ونطاق الصلاحية
- فحص الرمز في سيرفرك
- طلب بلا رمز وطلب برمز
- قائمة عمر قبل النشر
- تمارين الفصل
- حلول التمارين
26التغليف والنشر والمشروع الختامي
- من مطبخ البيت إلى المطعم
- حزمة يشغلها أي أحد
- صورة Docker
- على الإنترنت
- المشروع الختامي: مساعد الواحة
- طلب أخير
- ماذا بعد
- تمارين الفصل
- حلول التمارين



