تكامل خادم Chroma MCP

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

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

قائمة القوالب (Prompts)

لم يتم ذكر قوالب prompts في المستودع.

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

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

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

• chroma_list_collections – عرض جميع المجموعات مع دعم التصفح.
• chroma_create_collection – إنشاء مجموعة جديدة مع إمكانية ضبط HNSW اختياريًا.
• chroma_peek_collection – عرض عينة من المستندات في مجموعة.
• chroma_get_collection_info – الحصول على معلومات تفصيلية عن مجموعة.
• chroma_get_collection_count – الحصول على عدد المستندات في مجموعة.
• chroma_modify_collection – تحديث اسم المجموعة أو البيانات الوصفية الخاصة بها.
• chroma_delete_collection – حذف مجموعة.
• chroma_add_documents – إضافة مستندات مع بيانات وصفية واختياريًا معرفات مخصصة.
• chroma_query_documents – استعلام مستندات باستخدام البحث الدلالي مع تصفية متقدمة.

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

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

كيفية الإعداد

Windsurf

1. تأكد من تثبيت Node.js و npm.
2. افتح إعدادات أو مجلد إعدادات مشروع Windsurf الخاص بك.
3. حرر ملف الإعدادات لإضافة خادم Chroma MCP.
4. أدرج مقتطف JSON التالي أسفل mcpServers:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

5. احفظ الملف وأعد تشغيل Windsurf.
6. تحقق من تشغيل الخادم من خلال مراجعة سجل خوادم MCP أو لوحة التحكم.

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

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

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Claude

1. قم بتثبيت Node.js إذا لم يكن مثبتًا.
2. افتح ملف إعدادات Claude.
3. أضف هذا أسفل mcpServers:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

4. احفظ الملف وأعد تشغيل Claude.
5. راجع سجل النظام للتأكد من تسجيل الخادم بنجاح.

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

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Cursor

1. المتطلب الأساسي: تثبيت Node.js.
2. افتح ملف إعدادات/إعدادات Cursor.
3. أدرج إعدادات خادم Chroma MCP:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

4. احفظ وأعد تشغيل Cursor.
5. تحقق من الاتصال عبر لوحة إضافات Cursor.

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

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

Cline

1. تأكد من تثبيت Node.js.
2. ادخل إلى ملف إعدادات Cline.
3. أضف خادم Chroma MCP:

   {
     "chroma-mcp": {
       "command": "npx",
       "args": ["@chroma-core/chroma-mcp@latest"]
     }
   }
   

4. احفظ التغييرات وأعد تشغيل التطبيق.
5. تأكد من ظهور خادم MCP في واجهة Cline.

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

{
  "chroma-mcp": {
    "env": {
      "CHROMA_API_KEY": "${CHROMA_API_KEY}"
    },
    "inputs": {
      "api_key": "${CHROMA_API_KEY}"
    }
  }
}

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

استخدام MCP في FlowHunt

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

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

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

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

نظرة عامة

أقيّم هذا الخادم MCP بـ 6/10. إنه قوي من حيث أدوات قاعدة البيانات والإعداد، لكنه يفتقر إلى توثيق واضح للقوالب، والموارد، وميزات MCP المتقدمة مثل الجذور (roots) والمعاينة (sampling).

تقييم MCP