/ الدليل / الملعب / Context7
● رسمي upstash ⚡ فوري

Context7

بواسطة upstash · upstash/context7

يقوم Context7 بحقن مستندات جديدة خاصة بالإصدار لأكثر من 30 ألف مكتبة في عامل الترميز الخاص بك حتى يتوقف عن هلوسة واجهات برمجة التطبيقات غير الموجودة.

Context7 هي منصة Upstash's docs - for - LLMs. يقوم خادم MCP بحل اسم مكتبة إلى معرف ثابت، ثم يجلب مقتطفات المستند الدقيقة التي يحتاجها وكيلك — مثبتة في الإصدار الموجود في ملف القفل الخاص بك. يعمل المستوى المجاني خارج الصندوق ؛ يرفع مفتاح API المجاني حدود السعر. تم تثبيتها من أمر npx واحد، وهي واحدة من أعلى MCPs ذات العائد على الاستثمار لأي سير عمل ترميز يمتد على أكثر من مكتبتين.

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

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

عرض مباشر

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

context7.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "context7",
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "context7": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@upstash/context7-mcp@latest"
        ]
      }
    }
  }
}

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

claude mcp add context7 -- npx -y @upstash/context7-mcp@latest

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

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

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

أوقف وكيلك من وظائف الهلوسة التي لا وجود لها

👤 أي شخص يستخدم مساعد ترميز الذكاء الاصطناعي مع مكتبة أحدث من قطع النموذج ⏱ ~5 min beginner

متى تستخدمه: أنت تعمل مع Next.js 15 أو Prisma 5 أو Drizzle أو LangChain 0.3 أو أي مكتبة سريعة الحركة ويستمر وكيلك في اختراع وظائف غير موجودة.

المتطلبات الأساسية
  • العقدة 18+ — العقدة - v
  • السياق 7 تم تثبيت لوحة التحكم الرئيسية — الصق كتلة التكوين أعلاه في إعدادات سطح المكتب / المؤشر / Windsurf من Claude
الخطوات
  1. قم بتسمية المكتبة بشكل صريح
    باستخدام Context7، اسحب أحدث مستندات PRISMA وأرني الطريقة الصحيحة لإجراء معاملة مع كتابات متداخلة.✓ تم النسخ
    → يستدعي الوكيل معرّف- المكتبة- ثم مستندات- الاستعلام مع استعلام ذي صلة، وليس ملخصًا على غرار ويكيبيديا
  2. قم بتثبيت نسخة إذا كان الأمر مهمًا
    أنا التالي@15.0.3. استخدم Context7 للحصول على مستندات بث جهاز توجيه التطبيق لهذا الإصدار بالضبط.✓ تم النسخ
    → يتضمن الاقتباس الإصدار ؛ يستخدم الرمز اصطلاحات قائمة على الملفات، وليس getServerSideProps
  3. تحقق من الرمز الخاص بك
    اقرأ الواردات في src/lib/db.ts، ثم استخدم Context7 للتحقق من أن كل وظيفة قمت باستيرادها موجودة بالفعل في رذاذ 0.30.x.✓ تم النسخ
    → لكل استيراد✓/✗تقرير مع روابط المستند

النتيجة: يستخدم مخرجات الوكيل واجهات برمجة تطبيقات حقيقية وحالية — المحاولة الأولى — بدلاً من واجهات برمجة التطبيقات المخترعة ذات المظهر المعقول.

المزالق
  • نسي الوكيل الاتصال بالسياق 7 في المنعطف الثاني — ضع "استخدم دائمًا Context7 لأسئلة المكتبة" في موجه النظام أو CLAUDE.md
  • اسم المكتبة غامض (مثل "supabase ") — اسمح لمطابقة معرف مكتبة الحل ؛ اختر الحزمة المحددة (supabase - js vs @supabase/ssr)
اجمعها مع: filesystem · github

سقالة ميزة جديدة باستخدام النمط الاصطلاحي الحالي

👤 يبدأ المهندسون ميزة في إصدار غير مألوف أو أحدث من إطار العمل ⏱ ~15 min intermediate

متى تستخدمه: تحتاج إلى إضافة المصادقة إلى تطبيق Next.js 15 وتريد تخطي مشاركات المدونة القديمة.

المتطلبات الأساسية
  • تم تحديد الإطار المستهدف — package.json أو pyproject.toml يسردها بالفعل
الخطوات
  1. اطلب التعابير الاصطلاحية الحالية
    باستخدام Context7، أحضر مستندات NextAuth v5 وقم بإعداد إعداد مزود بيانات الاعتماد لي. أريد النسخة التجريبية الحالية، وليس v4.✓ تم النسخ
    → تستخدم التعليمة البرمجية دالة المصادقة وتكوين متوافق مع الحافة من v5، وليس v4 getServerSession
  2. التحقق من ملاحظات الترحيل
    اسحب قسم "الترقية من الإصدار 4" من مستندات NextAuth وسرد ما أحتاج إلى تغييره في التعليمة البرمجية الحالية.✓ تم النسخ
    → قائمة بأسلوب مختلف للتغييرات المعطلة

النتيجة: يعمل رمز v5 على الالتزام الأول — وليس هجينًا نصف مهاجر.

المزالق
  • لا تغطي المستندات حالة الحافة الخاصة بك — Context7 عبارة عن مستندات فقط ؛ للسلوك غير الصادر، ارجع إلى المصدر عبر GitHub MCP
اجمعها مع: github · filesystem

مراجعة العلاقات العامة مع الاستشهادات الحقيقية للمستندات، وليس المشاعر

👤 المراجعون الذين يرغبون في دعم التعليقات بالأدلة ⏱ ~20 min intermediate

متى تستخدمه: مراجعة طلب شراء يستخدم واجهة برمجة تطبيقات مكتبة لست متأكدًا بنسبة 100 ٪ من صحتها.

الخطوات
  1. قراءة الفرق
    اسحب الفرق من PR #482. لكل مكالمة للمكتبة، استخدم Context7 للتحقق من التوقيع ووضع علامة على أي شيء يبدو بعيدًا.✓ تم النسخ
    → حكم لكل مكالمة مع رابط المستند والإصدار
  2. اكتب تعليقات قابلة للاستشهاد بها
    لكل مكالمة تم الإبلاغ عنها، قم بصياغة تعليق مراجعة يربط المستند الرسمي عبر Context7.✓ تم النسخ
    → تُقرأ التعليقات مثل 'per the v15 docs<link>, X should be Y'

النتيجة: مراجعة التعليقات مع الاقتباسات، وليس الآراء.

اجمعها مع: github

ترحيل قاعدة التعليمات البرمجية إلى إصدار رئيسي جديد من المكتبة

👤 المهندسون يقومون بتحديث كبير (React 18→19، Tailwind 3→4، وما إلى ذلك) ⏱ ~90 min advanced

متى تستخدمه: أنت تطرح إصدارًا رئيسيًا ودليل الترقية يتكون من 40 صفحة من "الأمر يعتمد على ذلك".

المتطلبات الأساسية
  • تم اختيار الإصدار المستهدف — اختر الإصدار الدقيق؛ لا تفعل "الأحدث" في التخصصات
الخطوات
  1. اسحب دليل الهجرة
    استخدم context7 للحصول على مستند الترحيل Tailwind v3 → v4. تلخيص كقائمة مرجعية.✓ تم النسخ
    → قائمة مرجعية مرتبة للتغييرات العاجلة
  2. مسح الريبو لكل قضية
    بالنسبة لكل عنصر في قائمة التحقق هذه، استخدم نظام الملفات MCP للعثور على الأنماط المطابقة في src/. أعطني تقريرا لكل ملف.✓ تم النسخ
    → النمط → قائمة الملفات المتأثرة
  3. التصحيح في الالتزامات الصغيرة
    اجعل كل عنصر ترحيل التزامًا منفصلاً برسالة تشير إلى قسم المستند.✓ تم النسخ
    → سجل الالتزام النظيف، يمكنك الرجوع بندًا بندًا

النتيجة: يمكنك بالفعل مراجعة العلاقات العامة الخاصة بالترحيل، مع ربط كل تغيير بقسم المستند.

المزالق
  • أخذ عدد كبير جدًا من العناصر في التزام واحد — تغيير كسر واحد → التزام واحد؛ يجعل التقسيم سهلاً إذا انكسر شيء ما
اجمعها مع: filesystem · git · github

التركيبات

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

context7 + filesystem

اقرأ ملف package.json لاختيار الإصدار الدقيق، ثم استعلم عن context7 لمطابقة المستندات

اقرأ package.json، وابحث عن الإصدار التالي، واسحب المستندات المطابقة من context7 لإجراءات الخادم.✓ تم النسخ
context7 + github

بالنسبة إلى العلاقات العامة التي تلامس واجهات برمجة تطبيقات المكتبة، قم بإضافة تعليق توضيحي للمراجعة باستخدام استشهادات المستند

لكل استدعاء API في PR #482، قم بإضافة تعليق مراجعة مستشهدًا بمستندات context7.✓ تم النسخ

خطط للترحيل خطوة بخطوة قبل لمس الرمز

استخدم التفكير المتسلسل للتخطيط لترحيل Prisma v4 → v5، وسحب أدلة المستند من context7 في كل خطوة.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
resolve-library-id libraryName: str المكالمة الأولى - قم بإزالة الغموض عن اسم المكتبة الذي يهمك 1 free request
query-docs libraryId: str, query: str, version?: str بعد حل معرف المكتبة - اطرح السؤال الفعلي 1 free request (higher rate limit with API key)

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

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

حصة API
الطبقة المجانية سخية. مفتاح API المجاني (context7.com/dashboard) يرفع حدود المعدل
الرموز لكل استدعاء
~200-2000 لكل استعلام اعتمادًا على طول المستند
التكلفة المالية
حر
نصيحة
استعلامات النطاق - "كيفية استخدام X" أرخص من "أعطني كل شيء عن X"؛ يقوم الخادم بالفعل بإرجاع المقتطفات المركزة

الأمان

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

تخزين بيانات الاعتماد: اختياري CONTEXT7_API_KEY env var لحدود المعدلات الأعلى
نقل البيانات الخارجي: تذهب الاستعلامات إلى api.context7.com؛ لا يوجد خروج للكود - يتم إرسال اسم المكتبة واستعلامك فقط

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

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

لم يتم العثور على المكتبة بواسطة Resolve-library-id

جرب أسماء بديلة (على سبيل المثال، 'nextjs' مقابل 'next.js' مقابل '@vercel/next')؛ يتم فهرسة context7 حسب الأسماء المستعارة الشائعة ولكن ليس كل مفترق

تحقق: Check context7.com/browse for the official slug
تبدو المستندات قديمة

قم بتضمين نسخة صريحة arg; وبدونها تحصل على أحدث المستندات المفهرسة بالمكتبة والتي قد تتأخر عن الإصدارات بساعات

تحقق: Compare the returned snippet URL to the official docs site
تم الوصول إلى الحد الأقصى للسعر عند الاستخدام المجهول

احصل على مفتاح API مجاني على context7.com/dashboard وقم بتعيين CONTEXT7_API_KEY في كتلة env الخاصة بتكوين MCP

تحقق: Re-run the same query and check it succeeds

البدائل

Context7 مقابل البدائل

البديلمتى تستخدمهاالمقايضة
GitHub MCP (docs folder)أنت بحاجة إلى الحقيقة على مستوى المصدر أو السلوك الذي لم يتم الكشف عنهزمن الوصول لكل ملف مرتفع؛ يجب عليك التنقل في الريبو يدويًا
Ref Toolsتريد موفر مستندات مختلفًا بفهرسه الخاصتغطية مكتبة مختلفة
Direct web fetchالمستند ليس موجودًا في أي فهرس — لديك عنوان URLلا يوجد دقة الإصدار؛ أنت تقوم بعمل URL

المزيد

الموارد

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

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

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