🤖HermesBlog
Hermes Feature Guides · جزء 248/9/2026

MCP — Connect Hermes to Thousands of Tools

MCP — Connect Hermes to Thousands of Tools — easy-to-understand guide based on official docs

hermes-feature-24-mcp

MCP — اربط Hermes بآلاف الأدوات

إذا كنت يومًا ما تمنيت أن يتمكن Hermes من استخدام أداة موجودة بالفعل في مكان آخر — روبوت GitHub، عميل قاعدة بيانات، متصفح ملفات، واجهة برمجية داخلية — فإن MCP (بروتوكول سياق النموذج) هو أنظف طريقة لتحقيق ذلك.

يتيح MCP لـ Hermes الاتصال بخوادم أدوات خارجية، بحيث يمكن للوكيل استخدام أدوات تعيش خارج Hermes نفسه. اعتبره محولًا عالميًا: بدلاً من كتابة أداة Hermes أصلية من الصفر، فقط وجّه Hermes إلى خادم MCP وسيكتشف تلقائيًا الأدوات المتاحة.

ما الذي يوفره لك MCP

  • الوصول إلى أنظمة أدوات خارجية دون الحاجة لكتابة أداة Hermes أصلية أولاً
  • خوادم محلية وبعيدة معًا — خوادم stdio وخوادم MCP عبر HTTP تعمل في نفس الإعداد
  • اكتشاف تلقائي للأدوات عند بدء التشغيل — يجد Hermes كل شيء ويسجّله تلقائيًا
  • أغلفة مساعدة لموارد MCP والطلبات عندما يدعمها الخادم
  • تصفية لكل خادم — اعرض فقط أدوات MCP التي تريد فعلًا أن يراها Hermes

بداية سريعة

دعم MCP يأتي مع التثبيت القياسي — لا حاجة لخطوات إضافية. إليك كيفية البدء:

1. أضف خادم MCP إلى ~/.hermes/config.yaml:

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]

2. شغّل Hermes:

hermes chat

3. اطلب من Hermes استخدام الإمكانية المدعومة عبر MCP.

على سبيل المثال:

اسرد الملفات في /home/user/projects ولخّص بنية المستودع.

سيكتشف Hermes أدوات خادم MCP ويستخدمها مثل أي أداة أخرى. هذا كل شيء — لا إعدادات إضافية، ولا صيغة خاصة.

الكتالوج: تثبيت بنقرة واحدة لـ MCP المعتمدة من Nous

يأتي Hermes مع كتالوج منسّق لخوادم MCP التي راجعها فريق Nous ودمجها. وهي معطّلة افتراضيًا — ثبّت فقط ما تريده فعلًا.

hermes mcp                # منتقي تفاعلي (افتراضي)
hermes mcp catalog        # قائمة نصية عادية، قابلة للبرمجة النصية
hermes mcp install n8n    # تثبيت عنصر من الكتالوج بالاسم

يعرض المنتقي كل عنصر مع حالته الحالية:

n8n          available              إدارة وفحص سير عمل n8n من Hermes
linear       enabled                إدارة قضايا/مشاريع Linear (OAuth عن بُعد)
github       installed (disabled)   أدوات مستودعات GitHub + PR

اضغط Enter على صف للتثبيت أو التمكين أو التعطيل أو الإلغاء. يمكن أن تتطلب عناصر الكتالوج أنواعًا مختلفة من بيانات الاعتماد:

  • مفتاح API — يطلب Hermes الإدخال وقت التثبيت ويكتب القيمة في ~/.hermes/.env
  • OAuth (MCP عن بُعد) — يُكتب كـ auth: oauth في إعداداتك؛ يفتح عميل MCP متصفحًا عند أول اتصال
  • OAuth (مزود خارجي) — يوجهك Hermes إلى hermes auth <provider> إذا لم تكن قد سجّلت الدخول بعد

اختيار الأدوات وقت التثبيت

بعد تكوين بيانات الاعتماد، يفحص Hermes خادم MCP لسرد كل أداة يعرضها ويعرض قائمة اختيار:

حدد الأدوات لـ 'linear' (مسافة للتبديل، ENTER للتأكيد)
  [x] find_issues       البحث عن قضايا تطابق استعلامًا
  [x] get_issue         جلب قضية واحدة
  [x] create_issue      إنشاء قضية جديدة
  [ ] delete_workspace  حذف مساحة عمل Linear
  ...

الصفوف المحددة مسبقًا تأتي من:

  1. اختيارك السابق إذا كنت قد ثبّت هذا العنصر من قبل
  2. tools.default_enabled في البيان إذا كان العنصر يصرّح بذلك
  3. كل الأدوات إذا لم ينطبق أي مما سبق

أرسل قائمة الاختيار بزر ENTER. فقط الأدوات المحددة تُضاف إلى mcp_servers.<name>.tools.include. إذا حددت كل شيء، لا يُكتب أي فلتر — أنظف شكل للإعداد، وسلوك متطابق.

إذا فشل الفحص (الخادم غير قابل للوصول، OAuth لم يكتمل بعد)، ينجح التثبيت على أي حال: تُطبَّق الإعدادات الافتراضية للبيان مباشرة، أو لا يُكتب أي فلتر. أعد تشغيل hermes mcp configure <name> بمجرد أن يصبح الخادم قابلًا للوصول للتحسين.

نموذج الثقة

تثبيت عنصر من الكتالوج يشغّل ما يحدده البيان — git clone، أوامر التمهيد، وفي النهاية كود خادم MCP نفسه. البيانات محكومة بمراجعة PR في مستودع hermes-agent، لذا راجعتها Nous قبل نشر كل عنصر — ولكن يجب عليك قراءة البيان قبل التثبيت، خاصة حقل source: ومستودعه، وأوامر install.bootstrap:، وأي استدعاء transport.command:.

البيانات موجودة في optional-mcps/<name>/manifest.yaml على GitHub. يعرض المنتقي رابط source: من البيان وقت التثبيت حتى تتمكن من التحقق بسرعة من المستودع الأصلي. تعرض لوحة الويب صفحة MCP نفس التفاصيل لكل عنصر في الكتالوج — النقل، نوع المصادقة، رابط النهاية، مصدر تثبيت git، أوامر التمهيد، وملاحظات الإعداد — مع عرض source: كرابط قابل للنقر.

توافق إصدارات البيانات

تثبّت البيانات manifest_version. الكتالوج متوافق مع الإصدارات الأحدث: إذا أضاف PR عنصرًا بإصدار أحدث مما يفهمه Hermes المثبت لديك، سيعرض المنتقي تحذيرًا (⚠ '<name>' يتطلب إصدارًا أحدث من Hermes) بدلاً من إخفائه بصمت. شغّل hermes update لتثبيت أحدث إصدار من Hermes عندما ترى ذلك.

استبدال ${ENV_VAR} وقت التشغيل

داخل transport.command وtransport.args وtransport.url وheaders لأي عنصر، تُحلّ عناصر ${VAR} وقت التشغيل من بيئتك — حتى تتمكن من إبقاء الأسرار خارج إعداداتك والرجوع إليها ديناميكيًا.

قادم من Claude Code؟

كتلة mcpServers في ملف ~/.claude.json لديك تقابل mcp_servers في config.yaml الخاص بـ Hermes — وhermes import-agent claude-code يهاجرها (مع المهارات والتعليمات) تلقائيًا.

MCP هو أسرع طريقة لمنح Hermes قوى خارقة دون إعادة اختراع العجلة. جرّبه اليوم.


📖 التوثيق الرسمي

この記事は Hermes Agent のالتوثيق الرسميに基づいています:التوثيق الرسمي › user-guide/features/mcp