تكامل خادم Hunter MCP

ماذا يفعل خادم “Hunter” MCP؟

يوفر خادم Hunter MCP تكاملًا بين واجهة Hunter API وأي مزود LLM يدعم بروتوكول Model Context Protocol (MCP)، مثل Claude لسطح المكتب. يمكّن هذا الخادم مساعدي الذكاء الاصطناعي من الوصول إلى بيانات B2B عن الأشخاص والشركات من منصة Hunter والاستعلام عنها والتعامل معها باستخدام اللغة الطبيعية. من خلال إتاحة نقاط نهاية واجهة Hunter API القوية كأدوات، يبسط الخادم سير العمل مثل البحث عن معلومات النطاق، والعثور على عناوين البريد الإلكتروني والتحقق منها، وإثراء بيانات الشركات، وإدارة العملاء المحتملين. يعزز هذا التكامل المطورين والمحترفين في الأعمال لأتمتة مهام توليد العملاء وإثرائهم، مما يسمح لوكلاء الذكاء الاصطناعي بالتفاعل بسلاسة مع مجموعات بيانات B2B الخارجية، وبالتالي زيادة الإنتاجية وتسريع عمليات تطوير الأعمال.

قائمة التعليمات البرمجية (Prompts)

لا توجد قوالب تعليمات برمجية صريحة مذكورة في المستودع أو التوثيق.

قائمة الموارد

لا توجد موارد MCP محددة مدرجة في المستودع أو التوثيق.

قائمة الأدوات

• البحث عن النطاقات
  يتيح البحث عن عناوين البريد الإلكتروني المرتبطة بنطاق محدد.
• مكتشف البريد الإلكتروني
  يجد عنوان البريد الإلكتروني الأكثر احتمالية لشخص ونطاق معينين.
• مدقق البريد الإلكتروني
  يتحقق من صحة وقابلية تسليم عنوان البريد الإلكتروني.
• إثراء البريد الإلكتروني
  يسترجع بيانات إضافية حول عنوان بريد إلكتروني معين.
• إثراء الشركات
  يوفر معلومات مفصلة حول شركة معينة.
• إنشاء العملاء المحتملين
  يتيح حفظ جهات الاتصال والشركات كعملاء محتملين في Hunter.

حالات الاستخدام لهذا الخادم MCP

• البحث عن النطاقات وتوليد العملاء
  أتمتة اكتشاف جهات اتصال الشركات ورسائل البريد الإلكتروني لحملات المبيعات والتواصل عبر البحث عن النطاقات وتحديد الأشخاص الرئيسيين.
• التحقق من البريد الإلكتروني للحملات
  التحقق من عناوين البريد الإلكتروني قبل إطلاق حملات التسويق أو المبيعات لتقليل معدل الارتداد وتحسين قابلية التسليم.
• إثراء جهات الاتصال والشركات
  جمع تفاصيل شاملة حول الشركات والأفراد لبناء ملفات عملاء غنية لأنظمة CRM.
• إدارة العملاء المحتملين تلقائيًا
  إضافة عملاء جدد إلى منصة Hunter بسلاسة من خلال واجهات الذكاء الاصطناعي الحوارية، لتبسيط سير عمل المبيعات.
• تكامل بيانات B2B
  دمج بيانات B2B محدثة في التطبيقات المخصصة أو وكلاء الذكاء الاصطناعي لتغذية اتخاذ القرار في الوقت الفعلي والتخصيص.

كيفية إعداده

Windsurf

1. تأكد من تثبيت Python 3.13+ وuv.
2. احصل على مفتاح API من Hunter.
3. عدّل أو أنشئ ملف الإعدادات الخاص بـ Windsurf.
4. أضف خادم Hunter MCP باستخدام المقتطف التالي:

   {
     "mcpServers": {
       "hunter-mcp": {
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp[cli]",
           "mcp",
           "run",
           "PATH_TO_hunter-mcp/main.py"
         ],
         "env": {
           "HUNTER_API_KEY": "YOUR_HUNTER_API_KEY"
         }
       }
     }
   }
   

5. احفظ الإعدادات وأعد تشغيل Windsurf.
6. تحقق من أن الخادم يعمل ويمكن الوصول إليه.

Claude

1. تأكد من تثبيت Python 3.13+ وuv.
2. احصل على مفتاح Hunter API الخاص بك.
3. نفّذ الأمر التالي في الطرفية:

   mcp install main.py -v HUNTER_API_KEY=YOUR_HUNTER_API_KEY
   

4. قم بإعداد Claude للاتصال بخادم MCP الجديد.
5. اختبر الوصول من خلال تفعيل أداة Hunter عبر Claude.

Cursor

1. ثبّت Python 3.13+ وuv.
2. احصل على مفتاح Hunter API الخاص بك.
3. ابحث عن إعدادات MCP في إعدادات Cursor.
4. أضف خادم Hunter MCP كما يلي:

   {
     "mcpServers": {
       "hunter-mcp": {
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp[cli]",
           "mcp",
           "run",
           "PATH_TO_hunter-mcp/main.py"
         ],
         "env": {
           "HUNTER_API_KEY": "YOUR_HUNTER_API_KEY"
         }
       }
     }
   }
   

5. احفظ وأعد تشغيل Cursor لتفعيل الخادم.

Cline

1. تأكد من تثبيت Python 3.13+ وuv.
2. احصل على مفتاح Hunter API الخاص بك.
3. عدّل ملف إعدادات MCP لـ Cline.
4. أضف المقتطف التالي:

   {
     "mcpServers": {
       "hunter-mcp": {
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp[cli]",
           "mcp",
           "run",
           "PATH_TO_hunter-mcp/main.py"
         ],
         "env": {
           "HUNTER_API_KEY": "YOUR_HUNTER_API_KEY"
         }
       }
     }
   }
   

5. احفظ التغييرات وأعد تشغيل Cline.

تأمين مفاتيح API

دائمًا خزّن مفاتيح API الحساسة باستخدام متغيرات البيئة، وليس بشكل صريح في ملفات الإعداد. مثال:

{
  "mcpServers": {
    "hunter-mcp": {
      "env": {
        "HUNTER_API_KEY": "${HUNTER_API_KEY}"
      },
      "inputs": {
        "HUNTER_API_KEY": "your-api-key"
      }
    }
  }
}

كيفية استخدام هذا MCP داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في سير عمل FlowHunt الخاص بك، ابدأ بإضافة مكوّن MCP إلى التدفق وربطه بوكيل الذكاء الاصطناعي الخاص بك:

انقر على مكون MCP لفتح لوحة الإعدادات. في قسم إعدادات النظام لـ MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق:

{
  "hunter-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بعد الإعداد، سيتمكن وكيل الذكاء الاصطناعي الآن من استخدام هذا MCP كأداة مع الوصول لجميع وظائفه وإمكاناته. تذكّر تغيير “hunter-mcp” إلى اسم خادم MCP الفعلي الخاص بك واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

رأينا

يقدم هذا الخادم MCP تكاملًا قويًا مع Hunter API، ما يجعل بيانات B2B وإدارة العملاء المحتملين متاحة لأدوات تعتمد على LLM. مع ذلك، يفتقر إلى قوالب تعليمات برمجية ووثائق موارد، ولا يذكر ميزات MCP المتقدمة مثل الجذور أو أخذ العينات. الشيفرة مفتوحة المصدر بترخيص مرن، لكن المشروع لا يزال في بداياته مع مشاركة مجتمعية متواضعة. إجمالًا، هو خيار جيد لمستخدمي Hunter API الباحثين عن توافق مع MCP، لكنه قد يستفيد من مزيد من التوثيق ودعم ميزات MCP.

تقييم MCP