/ الدليل / الملعب / cocoindex-claude
● مجتمع cocoindex-io ⚡ فوري

cocoindex-claude

بواسطة cocoindex-io · cocoindex-io/cocoindex-claude

يعلم Claude Code كيفية بناء خطوط أنابيب تحويل البيانات في CocoIndex — معالجة زيادية فورية لقواعس بيانات المتجهات والرسوم البيانية للمعرفة.

CocoIndex هي إطار عمل لتحويل البيانات في الوقت الفعلي لخطوط أنابيب الذكاء الاصطناعي (مصدر → تحويل → قاعدة بيانات متجهات / رسم بياني للمعرفة). تحمل هذه المهارة اتفاقياتها إلى Claude Code حتى يكتب النموذج تدفقات CocoIndex اللغوية والوظائف المخصصة وأوامر CLI/API بدلاً من التخمين بشأن مكتبة غير مألوفة.

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

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

عرض مباشر

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

cocoindex-claude-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add cocoindex-claude-skill -- git clone https://github.com/cocoindex-io/cocoindex-claude ~/.claude/skills/cocoindex-claude

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

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

استخدامات عملية: cocoindex-claude

بناء خط أنابيب CocoIndex الأول من مجلد محلي إلى قاعدة بيانات متجهات

👤 المطورون الذين يقيمون CocoIndex لحالة استخدام RAG ⏱ ~30 min intermediate

متى تستخدمه: لقد قرأت الصفحة الرئيسية لـ CocoIndex وتريد من Claude أن ينشئ سقالة لتدفق عامل بدلاً من نسخ الدروس.

المتطلبات الأساسية
  • تم استنساخ المهارة إلى ~/.claude/skills/cocoindex-claude — git clone https://github.com/cocoindex-io/cocoindex-claude ~/.claude/skills/cocoindex-claude
  • تثبيت حزمة cocoindex Python — pip install cocoindex
الخطوات
  1. وصف الخط
    استخدم مهارة cocoindex — أنشئ سقالة لتدفق يراقب ./docs، وينقسم markdown، ويدمج مع OpenAI، ويكتب إلى Qdrant.✓ تم النسخ
    → Claude ينشئ flow.py مع @cocoindex.flow_def واستدعاءات source/transform/export الصحيحة
  2. تشغيل والتحقق
    الآن أظهر لي أوامر CLI الدقيقة لبناء وتشغيل وتحديث هذا التدفق بشكل زيادي.✓ تم النسخ
    → أوامر cocoindex setup / update / eval بالترتيب الصحيح

النتيجة: flow.py عامل بالإضافة إلى الأوامر لتشغيله — لا مزيد من التخمين حول سطح مزخرف CocoIndex.

المزالق
  • Claude يخترع APIs غير موجودة في CocoIndex — اطلب بشكل صريح 'استخدم فقط APIs موثقة في مهارة cocoindex' — تنخفض الهلوسة عندما تكون المهارة في النطاق
اجمعها مع: filesystem

كتابة وظيفة تحويل CocoIndex مخصصة

👤 المهندسون الذين يوسعون تدفق CocoIndex الموجود ⏱ ~25 min intermediate

متى تستخدمه: التحويلات المدمجة لا تغطي خطوة التحليل / الإثراء الخاصة بك.

الخطوات
  1. وصف التحويل
    باستخدام مهارة cocoindex — اكتب @cocoindex.op.function التي تأخذ مسار PDF، وتستخرج الجداول، وتُرجع صفوفاً منظمة.✓ تم النسخ
    → توقيع دالة اللغة مع مدخلات/مخرجات مكتوبة بشكل صحيح
  2. ربطها بالتدفق
    الآن أدخل هذا في تدفقي الموجود في مرحلة التقسيم.✓ تم النسخ
    → Diff مقابل flow.py الحالي مع العملية الجديدة في مكانها

النتيجة: تحويل مخصص يطيع دلالات المعالجة الزيادية في CocoIndex.

المزالق
  • تُرجع الدالة مخرجات غير حتمية، مما يكسر المعالجة الزيادية — تذكر المهارة Claude بأن التحويلات يجب أن تكون نقية — إذا واجهت هذا، أعد قراءة قسم المعالجة الزيادية

التركيبات

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

cocoindex-claude-skill + filesystem

اسمح لـ Claude بكتابة ملف flow.py فعلياً إلى القرص، وليس فقط طباعته في الدردشة

أنشئ سقالة لتدفق CocoIndex واحفظه في ./pipelines/docs_to_qdrant.py.✓ تم النسخ
cocoindex-claude-skill + postgres

أرسل مخرجات CocoIndex إلى متجر متجهات Postgres واستعلم عنها من نفس الجلسة

بناء التدفق الذي يستهدف pgvector، ثم قم بتشغيل استعلام استرجاع ضده.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
scaffold_flow source type + sink type + transform steps بدء خط أنابيب جديد 0
write_custom_op function intent + input/output types التحويلات المدمجة ليست كافية 0
cli_guidance task (setup / update / eval / drop) أنت غير متأكد ما إذا كان يجب إعادة البناء أو التحديث الزيادي 0

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

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

حصة API
لا يوجد
الرموز لكل استدعاء
متواضع — تحمل المهارة مواد مرجعية فقط عند الصلة
التكلفة المالية
مجاني — المهارات عبارة عن ملفات محلية
نصيحة
CocoIndex نفسها مجانية؛ التكاليف تأتي من نموذج التضمين الخاص بك وقاعدة بيانات المتجهات، وليس هذه المهارة.

الأمان

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

تخزين بيانات الاعتماد: لا بيانات اعتماد — مطالبات نقية
نقل البيانات الخارجي: لا شيء من المهارة نفسها. يستدعي خط أنابيبك أي خدمات تضمين / قاعدة بيانات تقوم بتكوينها.

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

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

لم يتم استدعاء المهارة عندما تسأل عن CocoIndex

قل 'استخدم مهارة cocoindex' بشكل صريح، أو تحقق من أنها مثبتة في ~/.claude/skills/cocoindex-claude.

تحقق: ls ~/.claude/skills/cocoindex-claude/SKILL.md
SKILL.md frontmatter خاطئ

افتح الملف والتحقق من أن name / description ممتلئة. أعد استنساخ إذا كانت جزئية.

تحقق: head ~/.claude/skills/cocoindex-claude/SKILL.md
كلمات مفتاح الزناد خاطئة — Claude يكتب Python عام بدلاً من CocoIndex

ذكر CocoIndex بشكل صريح، أو قل 'أنشئ سقالة لـ cocoindex flow_def'.

البدائل

cocoindex-claude مقابل البدائل

البديلمتى تستخدمهاالمقايضة
مهارات LlamaIndexتريد تجريدات استرجاع LlamaIndex بدلاً من نموذج CocoIndex الموجه للتحويلنموذج عقلي مختلف — LlamaIndex موجهة للاسترجاع أولاً، CocoIndex موجهة للخط الأول
Python مكتوب يدويًاتحتاج إلى معالجة لمرة واحدة ولا تريد الحالة الزياديةلا إعادة بناء زيادية، لا اتفاقيات إطار العمل

المزيد

الموارد

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

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

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