yujunjun/context7

Fork 0

mirror of https://github.com/upstash/context7.git synced 2025-06-26 23:50:04 +00:00

Abdusshh e66cdafe3c chore(format): run prettier

2025-06-07 00:24:20 +03:00

7.6 KiB

Raw Permalink Blame History

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"]
    }
  }
}

باستخدام 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

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

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

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

Context7 في الإعلام

سجل النجوم

الترخيص

MIT

7.6 KiB Raw Permalink Blame History Unescape Escape