
Claude MCP
Connect Claude to your tools and build your servers in Python
Discover how to make Claude work safely with your files and tools by building your own servers.
What you'll learn
- Understand how the Model Context Protocol (MCP) works and how to apply it.
- Build servers using Claude Desktop and Claude Code.
- Develop servers in Python with inputs and outputs.
- Run tests with pytest to ensure code quality.
- Create servers that work with databases and web services.
- Secure servers using token authentication.
About this book
This practical book by Ahmed Hassan Khamis, a consultant in curriculum development and e-learning, gives you everything you need to understand the Model Context Protocol (MCP) and how to connect Claude to your data and tools. The book is made up of 400 color pages and contains practical labs, ready-made code, exercises and a summary in every chapter. You will learn how to build your own servers in Python through real projects.
You will start by learning how the host, the client and the server communicate, then move on to building ready-made servers using Claude Desktop and Claude Code. By the end of the book you will be able to carry out three complete projects, which gives you a full and useful learning experience.
Who this book is for
- Developers and programmers
- Data and automation specialists
- Technical teams that want to connect Claude to their files and tools
Why read this book
- A practical book with labs and ready-made code.
- Includes real projects to strengthen learning.
- Gives a simple explanation of complex concepts.
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
- على الإنترنت
- المشروع الختامي: مساعد الواحة
- طلب أخير
- ماذا بعد
- تمارين الفصل
- حلول التمارين






