Context7 Platform -- Up-to-date docs for AI agents
docs: add arabic docs
ahmedriad1523fc5fdde30
diff --git a/docs/README.ar.md b/docs/README.ar.mdnew file mode 100644index 00000000..287c36f7--- /dev/null+++ b/docs/README.ar.md@@ -0,0 +1,330 @@+# Context7 MCP - توثيق أكواد محدث لأي أمر برمجي++[](https://context7.com) [](https://smithery.ai/server/@upstash/context7-mcp) [<img alt="Install in VS Code (npx)" src="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Context7%20MCP&color=0098FF">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22context7%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40upstash%2Fcontext7-mcp%40latest%22%5D%7D)++## ❌ بدون Context7++تعتمد النماذج اللغوية الكبيرة على معلومات قديمة أو عامة حول المكتبات التي تستخدمها. مما يؤدي إلى:++- ❌ أمثلة أكواد قديمة مبنية على بيانات تدريب مضى عليها وقت طويل+- ❌ واجهات برمجة تطبيقات وهمية غير موجودة+- ❌ إجابات عامة لنسخ قديمة من الحزم++## ✅ مع Context7++يستخرج Context7 MCP التوثيق والأمثلة البرمجية المحدثة مباشرة من المصدر — ويضعها في طلبك للنموذج.++أضف `use context7` إلى طلبك في Cursor:++```txt+أنشئ مشروع Next.js بسيط باستخدام app router. use context7+```++```txt+أنشئ سكربت لحذف الصفوف التي تكون فيها المدينة فارغة "" باستخدام بيانات اعتماد PostgreSQL. use context7+```++يقوم Context7 بجلب الأمثلة المحدثة والتوثيق المناسب مباشرة إلى السياق.++* 1️⃣ اكتب طلبك بشكل طبيعي+* 2️⃣ أخبر النموذج بـ `use context7`+* 3️⃣ احصل على أكواد تعمل مباشرة++لا حاجة للتنقل بين التبويبات، لا واجهات برمجة تطبيقات وهمية، لا أكواد قديمة.++## 🛠️ البدء++### المتطلبات++* Node.js إصدار 18.0.0 أو أعلى+* Cursor، Windsurf، Claude Desktop أو أي عميل MCP آخر++### التثبيت عبر Smithery++لتثبيت Context7 MCP Server تلقائيًا لـ Claude Desktop:++```bash+npx -y @smithery/cli install @upstash/context7-mcp --client claude+```++### التثبيت في Cursor++اذهب إلى: `Settings` -> `Cursor Settings` -> `MCP` -> `Add new global MCP server`++أو أضف هذا إلى ملف `~/.cursor/mcp.json`:++```json+{+ "mcpServers": {+ "context7": {+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### التثبيت باستخدام Bun++```json+{+ "mcpServers": {+ "context7": {+ "command": "bunx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### التثبيت باستخدام Deno++```json+{+ "mcpServers": {+ "context7": {+ "command": "deno",+ "args": ["run", "--allow-env", "--allow-net", "npm:@upstash/context7-mcp"]+ }+ }+}+```++### التثبيت في Windsurf++```json+{+ "mcpServers": {+ "context7": {+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### التثبيت في VS Code++```json+{+ "servers": {+ "Context7": {+ "type": "stdio",+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### التثبيت في Zed++```json+{+ "context_servers": {+ "Context7": {+ "command": {+ "path": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ },+ "settings": {}+ }+ }+}+```++### التثبيت في Claude Code++```sh+claude mcp add context7 -- npx -y @upstash/context7-mcp@latest+```++### التثبيت في Claude Desktop++```json+{+ "mcpServers": {+ "Context7": {+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### التثبيت في BoltAI++```json+{+ "mcpServers": {+ "context7": {+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### باستخدام Docker++**Dockerfile:**++```Dockerfile+FROM node:18-alpine+WORKDIR /app+RUN npm install -g @upstash/context7-mcp@latest+CMD ["context7-mcp"]+```++**بناء الصورة:**++```bash+docker build -t context7-mcp .+```++**التهيئة داخل العميل:**++```json+{+ "mcpServers": {+ "Context7": {+ "command": "docker",+ "args": ["run", "-i", "--rm", "context7-mcp"],+ "transportType": "stdio"+ }+ }+}+```++### التثبيت في Windows++```json+{+ "mcpServers": {+ "github.com/upstash/context7-mcp": {+ "command": "cmd",+ "args": [+ "/c",+ "npx",+ "-y",+ "@upstash/context7-mcp@latest"+ ],+ "disabled": false,+ "autoApprove": []+ }+ }+}+```++### المتغيرات البيئية++```json+{+ "mcpServers": {+ "context7": {+ "command": "npx",+ "args": ["-y", "@upstash/context7-mcp@latest"],+ "env": {+ "DEFAULT_MINIMUM_TOKENS": "10000"+ }+ }+ }+}+```++### الأدوات المتوفرة++* `resolve-library-id`: يحول اسم مكتبة عام إلى معرف متوافق مع Context7.+* `get-library-docs`: يستخرج التوثيق حسب المعرف.++ * `context7CompatibleLibraryID`: مطلوب+ * `topic`: موضوع معين مثل "routing"+ * `tokens`: الحد الأعلى لعدد الرموز++## التطوير++```bash+bun i+bun run build+```++**التهيئة المحلية:**++```json+{+ "mcpServers": {+ "context7": {+ "command": "npx",+ "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]+ }+ }+}+```++**الاختبار باستخدام MCP Inspector:**++```bash+npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest+```++## استكشاف الأخطاء++### ERR\_MODULE\_NOT\_FOUND++استخدم `bunx` بدلاً من `npx`.++```json+{+ "mcpServers": {+ "context7": {+ "command": "bunx",+ "args": ["-y", "@upstash/context7-mcp@latest"]+ }+ }+}+```++### مشاكل في ESM++جرّب إضافة:++```json+{+ "command": "npx",+ "args": [+ "-y",+ "--node-options=--experimental-vm-modules",+ "@upstash/[email protected]"+ ]+}+```++### أخطاء عميل MCP++1. أزل `@latest`+2. جرّب `bunx`+3. جرّب `deno`+4. تأكد أنك تستخدم Node v18 أو أحدث++## إخلاء مسؤولية++المشاريع المدرجة في Context7 مساهم بها من المجتمع، ولا يمكن ضمان دقتها أو أمانها بشكل كامل. الرجاء الإبلاغ عن أي محتوى مريب باستخدام زر "الإبلاغ".++## Context7 في الإعلام++* [Better Stack: "أداة مجانية تجعل Cursor أذكى 10x"](https://youtu.be/52FC3qObp9E)+* [Cole Medin: "أفضل MCP Server لمساعدين الذكاء الاصطناعي البرمجيين"](https://www.youtube.com/watch?v=G7gK8H6u7Rs)+* [Context7 + SequentialThinking: هل هذا AGI؟](https://www.youtube.com/watch?v=-ggvzyLpK6o)+* [تحديث جديد من Context7 MCP](https://www.youtube.com/watch?v=CTZm6fBYisc)+* [إعداد Context7 في VS Code](https://www.youtube.com/watch?v=-ls0D-rtET4)+* [Context7: MCP جديد سيغير البرمجة](https://www.youtube.com/watch?v=PS-2Azb-C3M)+* [Cline & RooCode + Context7: قوة مضاعفة](https://www.youtube.com/watch?v=qZfENAPMnyo)+* [أفضل 5 MCP Servers لتجربة برمجة ساحرة](https://www.youtube.com/watch?v=LqTQi8qexJM)++## سجل النجوم++[](https://www.star-history.com/#upstash/context7&Date)++## الترخيص++MIT