MCP — Connect Hermes to Thousands of Tools
MCP — Connect Hermes to Thousands of Tools — easy-to-understand guide based on official docs
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
...
الصفوف المحددة مسبقًا تأتي من:
- اختيارك السابق إذا كنت قد ثبّت هذا العنصر من قبل
tools.default_enabledفي البيان إذا كان العنصر يصرّح بذلك- كل الأدوات إذا لم ينطبق أي مما سبق
أرسل قائمة الاختيار بزر 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