skill

باني MCP

دليل لإنشاء خوادم MCP (بروتوكول سياق النموذج) عالية الجودة تمكن نماذج اللغات الكبيرة (LLMs) من التفاعل مع الخدمات الخارجية عبر أدوات مصممة جيدا. استخدمه عند بناء خوادم MCP لدمج واجهات برمجة التطبيقات (APIs) أو الخدمات الخارجية، سواء في Python (FastMCP) أو Node/TypeScript (MCP SDK).

anthropics133,413+ تثبيتموثوق

نبذة

# دليل تطوير خادم 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add anthropics/skills`، أو استنسخ المستودع وانسخ مجلد `skills/mcp-builder` إلى دليل مهارات Claude الخاص بك.

عرض المصدر
الرخصة: Complete terms in LICENSE.txtبواسطة anthropics

أسئلة شائعة

ما هي مهارة باني 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.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل باني MCP ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
واجهة سطر الأوامر Hyperframes
واجهة سطر الأوامر (CLI) ل HyperFrames من job - لإنشاء الهياكل، والتحقق من الإطارات، وعرضها، وتعديل الجدول الزمني، والمعاينة، والتصيير محليا أو سحابيا،…1,214,920+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدمها عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجواب".869,010+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (التزام، فرع، وسم، أو قاعدة دمج) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (…696,572+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة