/ الدليل / الملعب / Semble
● مجتمع MinishLab ⚡ فوري

Semble

بواسطة MinishLab · MinishLab/semble

بحث في الكود يكلف ~2% من grep+read في tokens — دلالي ولفظي، محلي بالكامل، أقل من ثانية على مستودعات بمليون سطر.

Semble خادم MCP للبحث في الكود من Minish Lab. يُفهرس المستودع بتضمينات هجينة متفرقة+كثيفة ويُقدم لـ Claude نتائج بحث دلالية أدق من grep — لا حاجة لتفريغ ملفات كاملة. استخدام tokens أقل بكثير من نمط 'grep ثم قراءة' القياسي، خاصة على monorepos الكبيرة.

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

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

عرض مباشر

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

semble-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "semble-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "semble-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "semble-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "semble-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "semble-mcp",
      "command": "uvx",
      "args": [
        "--from",
        "semble[mcp]",
        "semble"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "semble-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "--from",
          "semble[mcp]",
          "semble"
        ]
      }
    }
  }
}

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

claude mcp add semble-mcp -- uvx --from semble[mcp] semble

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

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

استخدامات عملية: Semble

العثور على مكان تنفيذ مفهوم عبر مستودع كبير

👤 المهندسون الذين يستكشفون قواعد كود كبيرة ⏱ ~5 min beginner

متى تستخدمه: تحتاج إجابة 'أين يوجد منطق التحقق من جلسة session؟' في لقطة واحدة.

المتطلبات الأساسية
  • المستودع مُفهرَسsemble index . — التشغيل الأول يستغرق دقائق للمستودعات الكبيرة
الخطوات
  1. البحث
    Use semble. Find where session token validation logic lives. Return file:line ranges.✓ تم النسخ
    → 3-5 نتائج مع نطاقات file:line محددة
  2. القراءة الدقيقة
    Read just those line ranges (not whole files). Summarize the validation flow.✓ تم النسخ
    → ملخص تدفق مختصر؛ بصمة tokens صغيرة

النتيجة: إجابة على السؤال بجزء من tokens التي سيحرقها grep+read.

المزالق
  • فهرس قديم بعد rebases كبيرةsemble reindex أو إعداد خطاف مراقب للملفات
اجمعها مع: filesystem

مراجعة استخدام نمط برمجي عبر مستودع

👤 فرق إعادة الهيكلة ⏱ ~15 min intermediate

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

الخطوات
  1. المسح اللفظي
    Find all calls to legacy_token_check.✓ تم النسخ
    → قائمة مطابقة تامة
  2. المسح الدلالي
    Find functions that do the same job under a different name.✓ تم النسخ
    → تطبيقات مشابهة مُعلَّمة

النتيجة: نطاق إعادة الهيكلة معروف تمامًا قبل البدء.

المزالق
  • إيجابيات كاذبة في المسح الدلالي — تحقق من كل مرشح؛ semble يعطي درجة تشابه للتصفية

التركيبات

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

semble-mcp + filesystem

نمط بحث → قراءة دقيقة (فقط النطاقات التي يُعيدها semble)

Use semble to find candidates, then filesystem to read just the matched ranges.✓ تم النسخ
semble-mcp + github

بناء PR لإعادة الهيكلة مع تحديث جميع مواقع الاستدعاء

Find all call sites with semble, generate a PR that updates each.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
search query, k?, mode? الافتراضي — البحث بالمفهوم free
lexical_search pattern, k? رموز محددة / regex free
index path أول تشغيل / بعد إعادة هيكلة كبيرة free
reindex path اللحاق بعد التعديلات free

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

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

حصة API
لا شيء — محلي
الرموز لكل استدعاء
ضئيل جدًا — عادةً 100–500
التكلفة المالية
مجاني
نصيحة
افهرس المستودع مرة واحدة؛ الاستعلامات رخيصة. توفير tokens يتراكم.

الأمان

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

الحد الأدنى من الصلاحيات: Local file read for indexing
تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: لا شيء — التضمينات تبقى محلية

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

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

Indexing OOM on huge repos

قلل حجم الدفعة في التكوين أو افهرس كل حزمة على حدة

Search returns nothing relevant

أعد الفهرسة — نسختك المحلية قد تكون انجرفت؛ أو حسّن الاستعلام

uvx install hangs

سخّن مسبقًا بـ uv pip install semble[mcp]

البدائل

Semble مقابل البدائل

البديلمتى تستخدمهاالمقايضة
ripgrep + grep MCPتحتاج فقط بحثًا بالمطابقة التامةلا استرجاع دلالي؛ تكلفة tokens أعلى على النتائج
ast-grep / serenaتريد بحثًا هيكليًا واعيًا بالصيغةنموذج مختلف؛ ليس قائمًا على التضمينات

المزيد

الموارد

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

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

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