MCP متاح

خادم MCP الخاص بـ awesome-repositories.com.

وجه أي وكيل يدعم MCP إلى https://awesome-repositories.com/api/mcp. سيقوم أول استدعاء للأداة بإرشادك خلال عملية تسجيل دخول بضغطة واحدة عبر Google؛ بعد ذلك، يمكن لوكيلك البحث في الدليل حسب النية، وقراءة أي مستودع، والعثور على وثائقه. إنه خادم للقراءة فقط — بحث وقراءة، لا شيء للكتابة.

اتصل بالخادم — أمر واحد، لكل وكيل

يضيف الخادم إلى كل عميل MCP يكتشفه — Claude Desktop، وClaude Code، وCursor، وVS Code، وWindsurf، وCline، وCodex، وZed، وGoose، وCopilot CLI، والمزيد. ألحق -y لتخطي المطالبات، -g للتثبيت الشامل (على مستوى المستخدم)، أو --agent <client> لاستهداف واحد.

npx add-mcp https://awesome-repositories.com/api/mcp --name awesome-repositories

أو أضفه لكل عميل

Claude Code

claude mcp add --transport http awesome-repositories https://awesome-repositories.com/api/mcp

VS Code

code --add-mcp '{"name":"awesome-repositories","type":"http","url":"https://awesome-repositories.com/api/mcp"}'

Cursor / Codex / Windsurf / Zed

npx add-mcp https://awesome-repositories.com/api/mcp --agent cursor   # or: codex · windsurf · zed · cline · goose

Claude Desktop / أي عميل آخر — الصقه في إعدادات MCP الخاصة به

{
  "mcpServers": {
    "awesome-repositories": {
      "type": "http",
      "url": "https://awesome-repositories.com/api/mcp"
    }
  }
}

لا يوجد ترويسة Authorization — يتولى العميل عملية OAuth نيابة عنك.

اختياري — تثبيت مهارة البحث

تثبيت مهارة (كيفية حل النية للوصول إلى مسارات الوسوم والبحث بشكل جيد) في كل وكيل لديك، عبر الفهرس المعروف في /.well-known/agent-skills/index.json. تعلم هذه المهارة الوكيل كيفية تشغيل الأدوات؛ الاتصال أعلاه هو ما يربط الخادم فعلياً.

npx skills add https://awesome-repositories.com

المصادقة

OAuth 2.1 — لا يوجد رمز (token) للصقه. يقوم العميل باكتشاف خادم المصادقة تلقائياً من /.well-known/oauth-protected-resource، ويسجل نفسه (Dynamic Client Registration)، ثم يفتح علامة تبويب في المتصفح لتتمكن من تسجيل الدخول باستخدام Google. تحافظ رموز التحديث (Refresh tokens) على بقاء الجلسة نشطة. يمكن لكل مستخدم مسجل استدعاء أي أداة — هذا خادم للقراءة فقط، لذا لا يوجد شيء يحتاج إلى تقييد حسب الدور.

الأدوات

جميعها للقراءة فقط. متاحة لأي مستخدم مسجل.

search_repositories — بحث هجين BM25 + AI. إعادة ترتيب النتائج بواسطة الذكاء الاصطناعي مفعلة افتراضياً (يتم الرجوع إلى BM25 عند استنفاد الحصة اليومية)؛ مرر ai:false لاستخدام BM25 الخام. قم بالتضييق باستخدام filter_tag_paths.
search_metadata_tags — بحث هجين عبر شجرة الوسوم الموحدة — قم بحل المفهوم إلى مسار وسم قياسي قبل تصفية البحث.
get_repository — تفاصيل كاملة لمستودع واحد بواسطة المعرف الداخلي أو owner/repo، مع تعيينات الوسوم وعدد الوثائق.
list_curated_searches — سلاغ (slugs) البحث المثبتة من قبل المسؤولين — نقاط بداية مفيدة للاكتشاف.
list_repository_docs — صفحات التوثيق المفهرسة لمستودع ما (readme / doc)، كل منها مع رابط المصدر الخاص بها — اجلب نص الصفحة مباشرة من ذلك الرابط.