microsoft--mcp-for-beginners/translations/ar/03-GettingStarted/12-mcp-hosts/README.md

إعداد عملاء الاستضافة الشائعة لـ MCP

يشرح هذا الدليل كيفية تكوين واستخدام خوادم MCP مع تطبيقات الاستضافة الشائعة لـ AI. لكل مضيف طريقة تكوين خاصة به، ولكن بمجرد إعداده، يتواصل الجميع مع خوادم MCP باستخدام البروتوكول الموحد.

ما هو مضيف MCP؟

مضيف MCP هو تطبيق AI يمكنه الاتصال بخوادم MCP لتوسيع قدراته. فكر فيه على أنه "الواجهة الأمامية" التي يتفاعل المستخدمون معها، بينما توفر خوادم MCP الأدوات والبيانات كـ "الواجهة الخلفية".

flowchart LR
    User[👤 المستخدم] --> Host[🖥️ مضيف MCP]
    Host --> S1[خادم MCP أ]
    Host --> S2[خادم MCP ب]
    Host --> S3[خادم MCP ج]
    
    subgraph "المضيفين الشائعين"
        H1[كلود سطح المكتب]
        H2[في إس كود]
        H3[المؤشر]
        H4[كلين]
        H5[ويندسيرف]
    end

المتطلبات الأساسية

• خادم MCP للاتصال به (راجع Module 3.1 - First Server)
• تثبيت تطبيق المضيف على نظامك
• معرفة أساسية بملفات تكوين JSON

---

1. Claude Desktop

Claude Desktop هو تطبيق سطح المكتب الرسمي من Anthropic الذي يدعم MCP بشكل أصلي.

التثبيت

1. حمّل Claude Desktop من claude.ai/download
2. قم بالتثبيت وسجّل الدخول باستخدام حساب Anthropic الخاص بك

التكوين

يستخدم Claude Desktop ملف تكوين JSON لتعريف خوادم MCP.

موقع ملف التكوين:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

مثال على التكوين:

{
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"],
      "env": {
        "PYTHONPATH": "/path/to/your/server"
      }
    },
    "weather": {
      "command": "node",
      "args": ["/path/to/weather-server/build/index.js"]
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/mydb"
      }
    }
  }
}

خيارات التكوين

الحقل	الوصف	المثال
command	البرنامج التنفيذي للتشغيل	"python", "node", "npx"
args	وسائط سطر الأوامر	["-m", "my_server"]
env	متغيرات البيئة	{"API_KEY": "xxx"}
cwd	دليل العمل	"/path/to/server"

اختبار إعداداتك

1. احفظ ملف التكوين
2. أعد تشغيل Claude Desktop بالكامل (أغلق وافتح التطبيق)
3. افتح محادثة جديدة
4. ابحث عن أيقونة 🔌 التي تشير إلى وجود خادم متصل
5. جرب طلب استخدام أداة من أدواتك مع Claude

استكشاف أخطاء Claude Desktop وإصلاحها

عدم ظهور الخادم:

• تحقق من صحة ملف التكوين باستخدام مراجع JSON
• تأكد من صحة مسار الأمر
• تحقق من سجلات Claude Desktop: مساعدة → عرض السجلات

تعطل الخادم عند بدء التشغيل:

• اختبر الخادم يدويًا من الطرفية أولاً
• تحقق من إعداد متغيرات البيئة بشكل صحيح
• تأكد من تثبيت جميع التبعيات

---

2. VS Code مع GitHub Copilot

يدعم VS Code MCP عبر امتدادات GitHub Copilot Chat.

المتطلبات الأساسية

1. تثبيت VS Code إصدار 1.99 أو أحدث
2. تثبيت امتداد GitHub Copilot
3. تثبيت امتداد GitHub Copilot Chat

التكوين

يستخدم VS Code ملف .vscode/mcp.json في مساحة العمل أو إعدادات المستخدم.

تكوين مساحة العمل (.vscode/mcp.json):

{
  "servers": {
    "my-calculator": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    },
    "my-database": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

إعدادات المستخدم (settings.json):

{
  "mcp.servers": {
    "global-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-memory"]
    }
  },
  "mcp.enableLogging": true
}

استخدام MCP في VS Code

1. افتح لوحة دردشة Copilot (Ctrl+Shift+I / Cmd+Shift+I)
2. اكتب @ لرؤية الأدوات المتاحة من MCP
3. استخدم اللغة الطبيعية لاستدعاء الأدوات: "احسب 25 * 48 باستخدام الحاسبة"

استكشاف أخطاء VS Code وإصلاحها

عدم تحميل خوادم MCP:

• تحقق من لوحة الإخراج → "MCP" لسجلات الأخطاء
• أعد تحميل النافذة: Ctrl+Shift+P → "Developer: Reload Window"
• تحقق من تشغيل الخادم بشكل مستقل أولًا

---

3. Cursor

Cursor هو محرر شفرة AI أولي يدعم MCP بشكل مدمج.

التثبيت

1. حمّل Cursor من cursor.sh
2. قم بالتثبيت وسجّل الدخول

التكوين

يستخدم Cursor صيغة تكوين مشابهة لـ Claude Desktop.

موقع ملف التكوين:

• macOS: ~/.cursor/mcp.json
• Windows: %USERPROFILE%\.cursor\mcp.json
• Linux: ~/.cursor/mcp.json

مثال على التكوين:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

استخدام MCP في Cursor

1. افتح دردشة AI في Cursor (Ctrl+L / Cmd+L)
2. تظهر أدوات MCP تلقائيًا في الاقتراحات
3. اطلب من AI تنفيذ المهام باستخدام الخوادم المتصلة

---

4. Cline (موجه الأوامر)

Cline هو عميل MCP يعتمد على الطرفية، مثالي لسير العمل في سطر الأوامر.

التثبيت

npm install -g @anthropic/cline

التكوين

يستخدم Cline متغيرات البيئة ووسائط سطر الأوامر.

استخدام متغيرات البيئة:

export ANTHROPIC_API_KEY="your-api-key"
export MCP_SERVER_CALCULATOR="python -m mcp_calculator_server"

استخدام وسائط سطر الأوامر:

cline --mcp-server "calculator:python -m mcp_calculator_server" \
      --mcp-server "weather:node /path/to/weather/index.js"

ملف التكوين (~/.clinerc):

{
  "apiKey": "your-api-key",
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    }
  }
}

استخدام Cline

# بدء جلسة تفاعلية
cline

# استعلام فردي مع MCP
cline "Calculate the square root of 144 using the calculator"

# سرد الأدوات المتاحة
cline --list-tools

---

5. Windsurf

Windsurf هو محرر شفرة مدعوم بالذكاء الاصطناعي مع دعم MCP.

التثبيت

1. حمّل Windsurf من codeium.com/windsurf
2. قم بالتثبيت وأنشئ حسابًا

التكوين

يتم إدارة تكوين Windsurf عبر واجهة الإعدادات:

1. افتح الإعدادات (Ctrl+, / Cmd+,)
2. ابحث عن "MCP"
3. انقر على "تعديل في settings.json"

مثال على التكوين:

{
  "windsurf.mcp.servers": {
    "my-tools": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {}
    }
  },
  "windsurf.mcp.enabled": true
}

---

مقارنة أنواع النقل

تدعم المضيفات المختلفة آليات نقل مختلفة:

المضيف	stdio	SSE/HTTP	WebSocket
Claude Desktop	✅	❌	❌
VS Code	✅	✅	❌
Cursor	✅	✅	❌
Cline	✅	✅	❌
Windsurf	✅	✅	❌

stdio (الإدخال/الإخراج القياسي): الأفضل للخوادم المحلية التي يبدأها المضيف
SSE/HTTP: الأفضل للخوادم البعيدة أو المشتركة بين عدة عملاء

---

استكشاف الأخطاء الشائعة وإصلاحها

الخادم لا يبدأ

1. اختبر الخادم يدويًا أولاً:

   # لـ بايثون
   python -m your_server_module
   
   # لـ نود.جي إس
   node /path/to/server/index.js
   

2. تحقق من مسار الأمر:

   • استخدم المسارات المطلقة متى أمكن
   • تأكد من وجود الملف التنفيذي في PATH الخاص بك

3. تحقق من التبعيات:

   # بايثون
   pip list | grep mcp
   
   # نود.جي إس
   npm list @modelcontextprotocol/sdk
   

الخادم متصل لكن الأدوات لا تعمل

1. تحقق من سجلات الخادم - معظم المضيفين يوفرون خيارات تسجيل
2. تحقق من تسجيل الأدوات - استخدم MCP Inspector للاختبار
3. تحقق من الأذونات - بعض الأدوات تحتاج إلى الوصول إلى الملفات/الشبكة

متغيرات البيئة غير ممررة

• بعض المضيفين يقومون بتنقية متغيرات البيئة
• استخدم حقل env في التكوين بشكل صريح
• تجنب تضمين البيانات الحساسة في ملفات التكوين (استخدم إدارة الأسرار)

---

أفضل ممارسات الأمان

1. لا تلتزم بمفاتيح API في ملفات التكوين
2. استخدم متغيرات البيئة للبيانات الحساسة
3. حد من أذونات الخادم فقط لما هو ضروري
4. راجع كود الخادم قبل منح الوصول لنظامك
5. استخدم قوائم السماح للوصول إلى نظام الملفات والشبكة

---

الخطوة التالية

• 3.13 - Debugging with MCP Inspector
• 3.1 - Create your first MCP server
• Module 5 - Advanced Topics

---

موارد إضافية

• وثائق Claude Desktop MCP
• امتداد VS Code MCP
• مواصفات MCP - النقل
• سجل خوادم MCP الرسمي

---

إخلاء المسؤولية:
تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى جاهدين لتحقيق الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الرسمي والموثوق. للمواد الحيوية أو الحساسة، يُنصح بالاعتماد على الترجمة المهنية البشرية. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.