عن المشروع

توفر منصة Context7 توثيقاً محدثاً ومحدد الإصدار وأمثلة برمجية من المكتبات مفتوحة المصدر مباشرة إلى سياقات نماذج اللغات الكبيرة. يعمل النظام عبر خادم MCP أو واجهة سطر أوامر مزودة بمهارات، ويتكامل مع مساعدي البرمجة بالذكاء الاصطناعي مثل Cursor وClaude Code وOpenCode. بدون Context7، تعتمد نماذج اللغات الكبيرة على بيانات تدريب قديمة، مما ينتج عنه أمثلة برمجية عفا عليها الزمن وواجهات برمجة تطبيقات مُتوهّمة وإجابات عامة لإصدارات قديمة من الحزم. يحل Context7 هذه المشكلة بجلب التوثيق المباشر من مستودعات المصدر بدقة الإصدار المطلوب. يمكن التثبيت عبر الأمر `npx ctx7 setup`، الذي يوجه عملية مصادقة OAuth ويولد مفتاح API (متوفر خطة مجانية عند context7.com/dashboard)، ويثبت إما مهارات CLI أو خادم MCP. يمكن توجيه الإعداد لوكلاء محددين باستخدام خيارات مثل `--cursor` أو `--claude` أو `--opencode`. لإزالة الإعداد لاحقاً، يُنصَر `npx ctx7 remove`. من أبرز الميزات: - دعم معرف المكتبة: أضف معرف مكتبة معروف (مثل `/supabase/supabase`) في المطالبة لتخطي مطابقة المكتبات وجلب التوثيق مباشرة. - تحديد الإصدار: اذكر إصداراً في مطلبك (مثل "Next.js 14") وسيطبع Context7 الإصدار المناسب تلقائياً. - أوامر CLI: `ctx7 library <name> <query>` يبحث في الفهرس؛ `ctx7 docs <libraryId> <query>` يسترجع مقتطفات توثيق ذات صلة. - أدوات MCP: `resolve-library-id` يربط اسماً عاماً بمعرف متوافق مع Context7؛ `query-docs` يجلب التوثيق باستخدام ذلك المعرف. تقدم المنصة حزم تكامل متعددة: - `@upstash/context7-mcp` — خادم MCP لتكامل الوكلاء - `ctx7` — واجهة سطر أوامر مستقلة - `@upstash/context7-sdk` — SDK بلغة TypeScript - `@upstash/context7-tools-ai-sdk` — أدوات Vercel AI SDK - `@upstash/context7-pi` — توسعة pi.dev يمكن التكوين اليدوي باستخدام نقطة نهاية MCP `https://mcp.context7.com/mcp` مع مفتاح API Bearer. يُدعم أكثر من 30 منصة عميل مع أدلة إعداد موثّقة. تُساهم المكتبات المجتمعية بواسطة صيانتها. يتضمن Context7 آلية إبلاغ للمحتوى المشكل ويوضح أن واجهة الخلفية للـ API ومحرك Parsing ومحرك Crawling خلف الخدمة هي مكونات خاصة غير مدرجة في المستودع العام. المشروع مرخّص بموجب رخصة MIT.