skill
باني MCP
دليل لإنشاء خوادم MCP (بروتوكول سياق النموذج) عالية الجودة تمكن نماذج اللغات الكبيرة (LLMs) من التفاعل مع الخدمات الخارجية عبر أدوات مصممة جيدا. استخدمه عند بناء خوادم MCP لدمج واجهات برمجة التطبيقات (APIs) أو الخدمات الخارجية، سواء في Python (FastMCP) أو Node/TypeScript (MCP SDK).
نبذة
# دليل تطوير خادم MCP
## نظرة عامة
أنشئ خوادم MCP (بروتوكول سياق النموذج) التي تمكن نماذج اللغات الكبيرة (LLMs) من التفاعل مع الخدمات الخارجية من خلال أدوات مصممة جيدا. تقاس جودة خادم MCP بمدى تمكينه لنماذج اللغات الكبيرة من إنجاز مهام واقعية.
---
# العملية
## 🚀 سير العمل عالي المستوى
يتضمن إنشاء خادم MCP عالي الجودة أربع مراحل رئيسية:
### المرحلة 1: البحث والتخطيط المتعمق
#### 1.1 فهم تصميم MCP الحديث
**تغطية API مقابل أدوات سير العمل:** وازن بين التغطية الشاملة لنقاط نهاية API وأدوات سير العمل المتخصصة. يمكن أن تكون أدوات سير العمل أكثر ملاءمة لمهام محددة، بينما تمنح التغطية الشاملة الوكلاء مرونة في تأليف العمليات. يختلف الأداء حسب العميل — يستفيد بعض العملاء من تنفيذ التعليمات البرمجية الذي يجمع بين الأدوات الأساسية، بينما يعمل البعض الآخر بشكل أفضل مع سير العمل عالي المستوى. عند عدم اليقين، أعط الأولوية للتغطية الشاملة ل API.
**تسمية الأدوات وقابليتها للاكتشاف:** تساعد أسماء الأدوات الواضحة والوصفية الوكلاء في العثور على الأدوات الصحيحة بسرعة. استخدم بادئات متسقة (مثل `github_create_issue`, `github_list_repos`) وتسمية موجهة نحو الإجراءات.
**إدارة السياق:** يستفيد الوكلاء من أوصاف الأدوات الموجزة والقدرة على تصفية/ترقيم النتائج. صمم أدواتا ترجع بيانات مركزة وذات صلة. يدعم بعض العملاء تنفيذ التعليمات البرمجية الذي يمكن أن يساعد الوكلاء في تصفية ومعالجة البيانات بكفاءة.
**رسائل الأخطاء القابلة للتنفيذ:** يجب أن توجه رسائل الأخطاء الوكلاء نحو الحلول باقتراحات محددة وخطوات تالية.
#### 1.2 دراسة وثائق بروتوكول MCP
**تصفح مواصفات MCP:**
ابدأ بخريطة الموقع للعثور على الصفحات ذات الصلة: `https://modelcontextprotocol.io/sitemap.xml`
ثم جلب صفحات محددة بلاحقة `.md` لتنسيق markdown (على سبيل المثال، `https://modelcontextprotocol.io/specification/draft.md`).
الصفحات الرئيسية للمراجعة: - نظرة عامة على المواصفات والهندسة المعمارية - آليات النقل (HTTP القابل للتدفق، stdio) - تعريفات الأدوات والموارد والمطالبات
#### 1.3 دراسة وثائق الإطار
**المكدس الموصى به:** - **اللغة**: TypeScript (دعم عالي الجودة ل SDK وتوافق جيد في العديد من بيئات التنفيذ مثل MCPB. بالإضافة إلى أن نماذج الذكاء الاصطناعي جيدة في توليد كود TypeScript، مستفيدة من استخدامه الواسع، والتحقق الثابت من النوع، وأدوات الفحص الجيدة) - **النقل**: HTTP القابل للتدفق للخوادم البعيدة، باستخدام JSON عديم الحالة (أبسط في التوسع والصيانة، على عكس الجلسات ذات الحالة والاستجابات المتدفقة). stdio للخوادم المحلية.
**تحميل وثائق الإطار:**
- **أفضل ممارسات MCP**: [📋 عرض أفضل الممارسات](./reference/mcp_best_practices.md) - الإرشادات الأساسية
**ل TypeScript (موصى به):**
يحتوي TypeScript SDK على إصدارين رئيسيين. اختر أحدهما قبل كتابة التعليمات البرمجية: - **v2** (`@modelcontextprotocol/server`): الإصدار المستقر الحالي. استخدمه للخوادم الجديدة. - **v1** (`@modelcontextprotocol/sdk`): يتلقى إصلاحات الأخطاء والأمان فقط. استخدمه فقط عندما يعتمد `package.json` للمشروع بالفعل على `@modelcontextprotocol/sdk`، أو قم بترحيل هذا المشروع باستخدام `npx @modelcontextprotocol/codemod@latest v1-to-v2 .`
إذا كان المشروع يستخدم v1 بالفعل، أخبر المستخدم مرة واحدة، في جملة أو اثنتين، أن v2 (`@modelcontextprotocol/server`) هو الإصدار المستقر الحالي، وأن v1 يتلقى فقط إصلاحات الأخطاء والأمان، وأن `npx @modelcontextprotocol/codemod@latest v1-to-v2 .` يقوم بترحيل المشروع. ثم استمر مع v1 ما لم يطلب المستخدم الترحيل.
لا تخلط بين الاثنين في مشروع واحد: عينات كود v1 (الواردات من `@modelcontextprotocol/sdk/...`) لا تنطبق على v2.
- **TypeScript SDK (v2)**: استخدم WebFetch لتحميل `https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/main/README.md`؛ فهرس الوثائق الكامل هو `https://ts.sdk.modelcontextprotocol.io/v2/llms.txt` - [⚡ دليل TypeScript (v2)](./reference/node_mcp_server_v2.md) - أنماط وأمثلة TypeScript - لمشاريع v1 فقط: `https://raw.githubusercontent.com/modelcontextprotocol/typescript-sdk/v1.x/README.md` و [دليل TypeScript (v1)](./reference/node_mcp_server.md)
**ل Python:** - **Python SDK**: استخدم WebFetch لتحميل `https://raw.githubusercontent.com/modelcontextprotocol/python-sdk/main/README.md` - [🐍 دليل Python](./reference/python_mcp_server.md) - أنماط وأمثلة Python
#### 1.4 خطط لتنفيذك
**فهم API:** راجع وثائق API للخدمة لتحديد نقاط النهاية الرئيسية، ومتطلبات المصادقة، ونماذج البيانات. استخدم البحث عبر الويب و WebFetch حسب الحاجة.
**اختيار الأدوات:** أعط الأولوية للتغطية الشاملة ل API. أدرج نقاط النهاية التي سيتم تنفيذها، بدءا من العمليات الأكثر شيوعا.
---
### المرحلة 2: التنفيذ
#### 2.1 إعداد هيكل المشروع
راجع الأدلة الخاصة باللغة لإعداد المشروع: - [⚡ دليل TypeScript (v2)](./reference/node_mcp_server_v2.md) - هيكل المشروع، package.json، tsconfig.json ([v1](./reference/node_mcp_server.md) لمشاريع v1 الحالية) - [🐍 دليل Python](./reference/python_mcp_server.md) - تنظيم الوحدات، التبعيات
#### 2.2 تنفيذ البنية التحتية الأساسية
أنشئ
التثبيت
شغل هذا الأمر
npx skills add anthropics/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add anthropics/skills`، أو استنسخ المستودع وانسخ مجلد `skills/mcp-builder` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة باني MCP؟
دليل لإنشاء خوادم MCP (بروتوكول سياق النموذج) عالية الجودة تمكن نماذج اللغات الكبيرة (LLMs) من التفاعل مع الخدمات الخارجية عبر أدوات مصممة جيدا. استخدمه عند بناء خوادم MCP لدمج واجهات برمجة التطبيقات (APIs) أو الخدمات الخارجية، سواء في Python (FastMCP) أو Node/TypeScript (MCP SDK).
كيف أثبت باني MCP؟
شغل هذا الأمر في الطرفية:
npx skills add anthropics/skillsمع أي أدوات ذكاء اصطناعي تعمل باني MCP؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور باني MCP؟
طورها anthropics، وتصدر بترخيص Complete terms in LICENSE.txt.
هل باني MCP مجانية؟
نعم، يمكنك استخدامها مجانا وفق ترخيص Complete terms in LICENSE.txt.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى