/ الدليل / الملعب / Weaviate Claude Skills
← كل الخوادم ↗ GitHub
● مجتمع saskinosie 🔑 يتطلب مفتاحك

Weaviate Claude Skills

بواسطة saskinosie · saskinosie/weaviate-claude-skills

Weaviate المحلي الشامل من Claude - الإعداد، والاتصال، والمخطط، والاستيعاب، وRAG في خمس مهارات مركزة.

saskinosie/weaviate-claude-skills عبارة عن سوق صغير يضم خمس مهارات تغطي سير عمل Weaviate: إعداد weaviate المحلي (إنشاء عامل الإرساء)، واتصال weaviate (فحص الصحة + المصادقة)، ومدير مجموعة weaviate (مسؤول المخطط والتجميع)، واستيعاب بيانات weaviate (استيراد فردي + دفعة + ملف)، ووكيل استعلام weaviate (البحث الدلالي، المرشحات، الهجين، RAG). يعمل مع Claude.ai وClaude Desktop؛ يمكنك إحضار قبو المستندات والمهارات التي تتعامل مع السباكة الخاصة بـ Vector DB.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

weaviate-claude-skills.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "weaviate-claude-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "weaviate-claude-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "weaviate-claude-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "weaviate-claude-skills": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "weaviate-claude-skills",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/saskinosie/weaviate-claude-skills",
        "~/.claude/skills/weaviate-claude-skills"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "weaviate-claude-skills": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/saskinosie/weaviate-claude-skills",
          "~/.claude/skills/weaviate-claude-skills"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add weaviate-claude-skills -- git clone https://github.com/saskinosie/weaviate-claude-skills ~/.claude/skills/weaviate-claude-skills

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Weaviate Claude Skills

قم بإعداد RAG محلي فوق مستنداتك في أقل من ساعة

👤 يبدأ المطورون نموذجًا أوليًا محليًا لـ RAG ⏱ ~60 min intermediate

متى تستخدمه: تريد الدردشة مع مستنداتك الخاصة دون إرسالها إلى بائع السحابة.

المتطلبات الأساسية
  • دوكر + بايثون 3.10+ — تثبيت دوكر سطح المكتب. pyenv إذا لزم الأمر
  • تم تثبيت المهارات — استنساخ بوابة في ~/.claude/skills/
الخطوات
  1. عامل ميناء-بدء Weaviate
    استخدم weaviate-local-setup لبدء إنشاء عامل إرساء لـ Weaviate محلي.✓ تم النسخ
    → يُظهر docker ps صحة weaviate على 8080
  2. إنشاء مجموعة
    قم بإنشاء مجموعة "Docs" تحتوي على الحقول: العنوان (النص)، النص (النص)، المصدر_url (النص).✓ تم النسخ
    → تم تطبيق المخطط؛ يقوم weaviate-collection-manager بإرجاع التكوين
  3. استيعاب
    استوعب كل .md ضمن ./docs ككائنات في "Docs".✓ تم النسخ
    → تم الإبلاغ عن تقدم الدفعة؛ الكائنات مرئية عبر الاستعلام
  4. بسأل
    استخدم weaviate-query-agent: "كيف نقوم بتدوير مفاتيح واجهة برمجة التطبيقات؟"✓ تم النسخ
    → تستشهد الإجابة بـ source_url من مجموعة المستندات

النتيجة: RAG محلي قابل للتشغيل يمكنك التكرار عليه.

المزالق
  • استيعاب ملفات PDF العملاقة بالكامل دون تقطيع — قطعة بقيمة 500 رمز تقريبًا؛ اسمح لقالب استيعاب المهارة بالتعامل معها
اجمعها مع: filesystem

قم بتكرار مخطط المجموعة بدون استدعاءات API اليدوية

👤 تعمل الفرق على تحسين مخطط المتجهات الخاص بها ⏱ ~20 min intermediate

متى تستخدمه: RAG المبكر — يتغير مخططك أسبوعيًا ولا تريد أوامر التجعيد.

الخطوات
  1. فحص المخطط الحالي
    إظهار مخطط "المستندات" - الحقول، والمتجه، وتكوين الفهرس.✓ تم النسخ
    → تم إرجاع التكوين الكامل
  2. اقتراح التغيير
    أضف خاصية التعداد "اللغة" (en/zh/ja)؛ احتفظ بالباقي.✓ تم النسخ
    → خطة الهجرة + تحذير احتياطي
  3. يتقدم
    يتقدم؛ أعد فهرسة الكائنات الـ 500 الموجودة.✓ تم النسخ
    → تقدم الوظيفة؛ التهم التوفيق

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

المزالق
  • على افتراض أن عمليات إزالة الممتلكات مجانية — تتطلب بعض التغييرات إعادة التضمين؛ علامات المهارة عندما تكون رخيصة مقابل باهظة الثمن

بحث مختلط + مرشح للحصول على إجابات موثوقة

👤 أي شخص يقوم بشحن RAG لمستخدمين حقيقيين ⏱ ~15 min intermediate

متى تستخدمه: البحث الدلالي البحت يفتقد مصطلحات المطابقة التامة؛ يعمل الهجين (BM25 + المتجه) على إصلاحه.

الخطوات
  1. تشغيل الاستعلامات المختلطة
    الاستعلام "رمز خطأ SAML SSO 42"، alpha=0.5 (الرصيد الدلالي + الكلمة الرئيسية).✓ تم النسخ
    → تتضمن أفضل النتائج التطابق الحرفي "42" ولكن أيضًا تلك ذات الصلة من الناحية المفاهيمية
  2. مرشحات الطبقة
    يحتوي عامل التصفية language='en' وsource_url على '/docs/auth/'.✓ تم النسخ
    → ضاقت الزيارات؛ يبقى الجواب مقتبسا

النتيجة: دقة أعلى في الاستعلامات ذات المصطلح المحدد دون فقدان الاستدعاء.

اجمعها مع: local-rag

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

weaviate-claude-skills + filesystem

استوعب الملفات المحلية عبر نظام الملفات MCP، ثم استعلم من خلال المهارة

قم بإدراج جميع عمليات التخفيض ضمن ./docs، واستوعبها في Weaviate 'Docs'، ثم ابحث عن السؤال المختلط.✓ تم النسخ
weaviate-claude-skills + local-rag

قارن بين الأساليب - عمليات التضمين فقط مقابل فهرس Weaviate المنظم

بالنسبة لهذه المجموعة، قم بمقياس هجين محلي مقابل Weaviate في 10 أسئلة تقييم.✓ تم النسخ
weaviate-claude-skills + qdrant

قم بتقييم اختيار قاعدة بيانات المتجهات على عبء العمل الخاص بك

قم بتشغيل نفس مجموعة التقييم على Weaviate وQdrant؛ تقرير الكمون + MRR.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
weaviate-local-setup (SKILL) (none) المرة الأولى فقط — إحضار Weaviate المحلي 0
weaviate-connection (SKILL) URL + API key التحقق من إمكانية الوصول والمصادقة 0
weaviate-collection-manager (SKILL) schema ops إنشاء مجموعة أو فحصها أو تطويرها 0
weaviate-data-ingestion (SKILL) object(s) or file paths إدراج فردي، أو إدراج دفعة، أو استيراد ملف 0
weaviate-query-agent (SKILL) query + filters + alpha البحث الدلالي / المختلط وإجابات RAG 0

التكلفة والحدود

تكلفة التشغيل

حصة API
لا شيء - يعمل Weaviate محليًا
الرموز لكل استدعاء
استعلام + حجم القطعة المستردة
التكلفة المالية
مجانا للمحلية. لدى Weaviate Cloud أسعارها الخاصة إذا قمت بالترحيل لاحقًا.
نصيحة
القطعة عمدا (~500 رمز)؛ القطع كبيرة الحجم تهدر كلاً من التخزين والسياق.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: قم بدمج مفاتيح API في .env، وليس في ملفات المهارات. يمكن للمطور المحلي تخطي المصادقة ولكن دون الكشف عن المنفذ.
نقل البيانات الخارجي: لا شيء يترك جهازك للإعداد المحلي. يرسل Cloud Weaviate إلى نقطة النهاية التي تم تكوينها.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

تم رفض الاتصال 8080

حاوية Weaviate لا تعمل. عامل الإرساء يؤلف -d في الإعداد المحلي weaviate.

تحقق: curl localhost:8080/v1/.well-known/ready
فشل تغيير المخطط

تتطلب بعض تغييرات الخاصية إعادة إنشاء المجموعة. تصدير، وإفلات، وإعادة إنشاء، وإعادة الاستيعاب.

تحقق: weaviate-collection-manager diff output
الاستعلامات البطيئة

تحقق من معلمات فهرس HNSW ومن تكوين أداة التوجيه هذه بشكل صحيح. تجنب الرجوع إلى النص الكامل في الحقول غير المفهرسة.

تحقق: Query explain in the skill's debug mode

البدائل

Weaviate Claude Skills مقابل البدائل

البديلمتى تستخدمهاالمقايضة
qdrantأنت تفضل أداء Qdrant's API وRustSDK مختلفة؛ قدرات مماثلة
local-ragتريد RAG محليًا خفيف الوزن بدون قاعدة بيانات متجهةأقل مرونة؛ لا يوجد مخطط
neo4jبياناتك علائقية/رسم بياني وليست متجهةنموذج مختلف

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills