mcp-server-milvus: شرح تفصيلي للمشروع

نظرة عامة على المشروع

mcp-server-milvus هو مشروع مفتوح المصدر تم تطويره بواسطة Zilliz Tech، ويوفر تطبيق خادم Model Context Protocol (MCP) لقاعدة بيانات Milvus المتجهة. يمكّن هذا المشروع تطبيقات LLM من التكامل والوصول بسلاسة إلى وظائف قاعدة بيانات Milvus المتجهة من خلال بروتوكول موحد.

الميزات والوظائف الأساسية

أدوات التشغيل المدعومة

يوفر خادم MCP الأدوات الأساسية التالية:

• milvus_text_search: البحث عن المستندات باستخدام وظيفة البحث عن النص الكامل

  • المعلمات: collection_name, query_text, limit, output_fields, drop_ratio

• milvus_vector_search: إجراء بحث عن التشابه المتجهي في المجموعة

  • المعلمات: collection_name, vector, vector_field, limit, output_fields, metric_type

• milvus_query: الاستعلام عن المجموعة باستخدام تعبير تصفية

  • المعلمات: collection_name, filter_expr, output_fields, limit

• milvus_list_collections: سرد جميع المجموعات في قاعدة البيانات

• milvus_create_collection: إنشاء مجموعة جديدة بمخطط محدد

  • المعلمات: collection_name, collection_schema, index_params

• milvus_load_collection: تحميل المجموعة في الذاكرة للبحث والاستعلام

  • المعلمات: collection_name, replica_number

• milvus_release_collection: تحرير المجموعة من الذاكرة

  • المعلمات: collection_name

• milvus_insert_data: إدراج البيانات في المجموعة

  • المعلمات: collection_name, data

• milvus_delete_entities: حذف الكيانات من المجموعة بناءً على تعبير تصفية

  • المعلمات: collection_name, filter_expr

متطلبات النظام

• Python 3.10 أو إصدار أحدث
• مثيل Milvus قيد التشغيل (محليًا أو عن بُعد)
• أداة uv (موصى بها لتشغيل الخادم)

التثبيت والتكوين

استنساخ المشروع

git clone https://github.com/zilliztech/mcp-server-milvus.git
cd mcp-server-milvus

تشغيل الخادم مباشرة

الطريقة الموصى بها هي استخدام uv لتشغيل الخادم مباشرةً، دون الحاجة إلى التثبيت:

uv run src/mcp_server_milvus/server.py --milvus-uri http://localhost:19530

أو عن طريق تعيين متغيرات البيئة في ملف .env:

uv run src/mcp_server_milvus/server.py

تطبيقات العميل المدعومة

يمكن لخادم MCP هذا العمل مع مجموعة متنوعة من تطبيقات LLM التي تدعم Model Context Protocol:

تكامل Claude Desktop

1. تثبيت Claude Desktop
2. تكوين ملف claude_desktop_config.json:

{
  "mcpServers": {
    "milvus": {
      "command": "/PATH/TO/uv",
      "args": [
        "--directory",
        "/path/to/mcp-server-milvus/src/mcp_server_milvus",
        "run",
        "server.py",
        "--milvus-uri",
        "http://localhost:19530"
      ]
    }
  }
}

تكامل محرر Cursor

يدعم Cursor طريقتين للتكوين:

الطريقة الأولى: التكوين عبر واجهة المستخدم الرسومية

1. انتقل إلى Cursor Settings > Features > MCP
2. انقر فوق الزر "+ Add New MCP Server"
3. املأ النموذج:
   • Type: حدد stdio
   • Name: milvus
   • Command: /PATH/TO/uv --directory /path/to/mcp-server-milvus/src/mcp_server_milvus run server.py --milvus-uri http://127.0.0.1:19530

الطريقة الثانية: ملف التكوين

إنشاء ملف .cursor/mcp.json:

{
  "mcpServers": {
    "milvus": {
      "command": "/PATH/TO/uv",
      "args": [
        "--directory",
        "/path/to/mcp-server-milvus/src/mcp_server_milvus",
        "run",
        "server.py",
        "--milvus-uri",
        "http://127.0.0.1:19530"
      ]
    }
  }
}

تكوين متغيرات البيئة

• MILVUS_URI: عنوان URI لخادم Milvus (بديل للمعامل --milvus-uri)
• MILVUS_TOKEN: رمز المصادقة الاختياري
• MILVUS_DB: اسم قاعدة البيانات (افتراضيًا "default")

أمثلة على الاستخدام

الاستخدام في Claude Desktop

يمكن للمستخدمين التفاعل مع قاعدة بيانات Milvus بلغة طبيعية:

الاستعلام عن قائمة المجموعات:

What are the collections I have in my Milvus DB?

البحث عن المستندات:

Find documents in my text_collection that mention "machine learning"

الاستخدام في Cursor

إنشاء مجموعة جديدة:

Create a new collection called 'articles' in Milvus with fields for title (string), content (string), and a vector field (128 dimensions)

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

مشاكل الاتصال

• تحقق من أن مثيل Milvus قيد التشغيل
• تحقق من أن تكوين URI صحيح
• تأكد من أن قواعد جدار الحماية لا تمنع الاتصال
• حاول استخدام 127.0.0.1 بدلاً من localhost

مشاكل المصادقة

• تحقق من أن MILVUS_TOKEN صحيح
• تحقق من أن مثيل Milvus يتطلب مصادقة
• تأكد من أن لديك الأذونات الصحيحة لتنفيذ العمليات

البنية التقنية

تم تطوير هذا المشروع باستخدام Python، ويعتمد على سلسلة أدوات تطوير حديثة:

• يستخدم uv لإدارة الحزم وتشغيل الأدوات
• يتبع مواصفات بروتوكول MCP القياسية
• يوفر تغليفًا كاملاً لعمليات قاعدة بيانات Milvus
• يدعم مجموعة متنوعة من تطبيقات عملاء الذكاء الاصطناعي

سيناريوهات التطبيق

ينطبق هذا المشروع بشكل أساسي على السيناريوهات التالية:

• تحسين محرر التعليمات البرمجية المدعوم بالذكاء الاصطناعي
• تحسين سياق واجهات الدردشة
• بناء سير عمل مخصص للذكاء الاصطناعي
• تكامل قاعدة البيانات المتجهة مع LLM
• البحث الدلالي وتطبيقات RAG (الاسترجاع المعزز بالتوليد)

من خلال mcp-server-milvus، يمكن للمطورين بسهولة دمج الإمكانات القوية لقاعدة بيانات Milvus المتجهة في مجموعة متنوعة من تطبيقات الذكاء الاصطناعي، مما يوفر للمستخدمين تجربة تفاعلية أكثر ذكاءً ودقة.