README.ar.md

Context7 MCP - توثيق أكواد محدث لأي أمر برمجي

❌ بدون Context7

تعتمد النماذج اللغوية الكبيرة على معلومات قديمة أو عامة حول المكتبات التي تستخدمها. مما يؤدي إلى:

• ❌ أمثلة أكواد قديمة مبنية على بيانات تدريب مضى عليها وقت طويل
• ❌ واجهات برمجة تطبيقات وهمية غير موجودة
• ❌ إجابات عامة لنسخ قديمة من الحزم

✅ مع Context7

يستخرج Context7 MCP التوثيق والأمثلة البرمجية المحدثة مباشرة من المصدر — ويضعها في طلبك للنموذج.

أضف use context7 إلى طلبك في Cursor:

أنشئ مشروع Next.js بسيط باستخدام app router. use context7

أنشئ سكربت لحذف الصفوف التي تكون فيها المدينة فارغة "" باستخدام بيانات اعتماد 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:

npx -y @smithery/cli install @upstash/context7-mcp --client claude

التثبيت في Cursor

اذهب إلى: Settings -> Cursor Settings -> MCP -> Add new global MCP server

أو أضف هذا إلى ملف ~/.cursor/mcp.json:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

التثبيت باستخدام Bun

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

التثبيت باستخدام Deno

{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": ["run", "--allow-env", "--allow-net", "npm:@upstash/context7-mcp"]
    }
  }
}

التثبيت في Windsurf

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

التثبيت في VS Code

{
  "servers": {
    "Context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

التثبيت في Zed

{
  "context_servers": {
    "Context7": {
      "command": {
        "path": "npx",
        "args": ["-y", "@upstash/context7-mcp@latest"]
      },
      "settings": {}
    }
  }
}

التثبيت في Claude Code

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

التثبيت في Claude Desktop

{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

التثبيت في BoltAI

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

التثبيت في Copilot Coding Agent

أضف التكوين التالي إلى قسم mcp في ملف إعدادات Copilot Coding Agent الخاص بك Repository->Settings->Copilot->Coding agent->MCP configuration:

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "tools": ["get-library-docs", "resolve-library-id"]
    }
  }
}

لمزيد من المعلومات، راجع التوثيق الرسمي على GitHub.

باستخدام Docker

Dockerfile:

FROM node:18-alpine
WORKDIR /app
RUN npm install -g @upstash/context7-mcp@latest
CMD ["context7-mcp"]

بناء الصورة:

docker build -t context7-mcp .

التهيئة داخل العميل:

{
  "mcpServers": {
    "Context7": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "context7-mcp"],
      "transportType": "stdio"
    }
  }
}

التثبيت في Windows

{
  "mcpServers": {
    "github.com/upstash/context7-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@upstash/context7-mcp@latest"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

المتغيرات البيئية

{
  "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: الحد الأعلى لعدد الرموز

التطوير

bun i
bun run build

التهيئة المحلية:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
    }
  }
}

الاختبار باستخدام MCP Inspector:

npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp@latest

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

ERR_MODULE_NOT_FOUND

استخدم bunx بدلاً من npx.

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

مشاكل في ESM

جرّب إضافة:

{
  "command": "npx",
  "args": ["-y", "--node-options=--experimental-vm-modules", "@upstash/context7-mcp@1.0.6"]
}

أخطاء عميل MCP

1. أزل @latest
2. جرّب bunx
3. جرّب deno
4. تأكد أنك تستخدم Node v18 أو أحدث

إخلاء مسؤولية

المشاريع المدرجة في Context7 مساهم بها من المجتمع، ولا يمكن ضمان دقتها أو أمانها بشكل كامل. الرجاء الإبلاغ عن أي محتوى مريب باستخدام زر "الإبلاغ".

Context7 في الإعلام

• Better Stack: "أداة مجانية تجعل Cursor أذكى 10x"
• Cole Medin: "أفضل MCP Server لمساعدين الذكاء الاصطناعي البرمجيين"
• Context7 + SequentialThinking: هل هذا AGI؟
• تحديث جديد من Context7 MCP
• إعداد Context7 في VS Code
• Context7: MCP جديد سيغير البرمجة
• Cline & RooCode + Context7: قوة مضاعفة
• أفضل 5 MCP Servers لتجربة برمجة ساحرة

سجل النجوم

الترخيص

MIT