iAct

Act on Ai

Context7 MCP در Open Code — حل مشکل Knowledge Cutoff


Context7 MCP در Open Code — حل مشکل Knowledge Cutoff

یه مشکل بزرگ AI کدینگ: knowledge cutoff. مدل‌ها داده‌های train شده‌شون تا یه تاریخ مشخصه. اگه می‌خوای با Next.js 16 کد بزنی و این نسخه بعد از training مدل اومده، مدل اطلاع نداره. Context7 این مشکل رو حل می‌کنه. توی این پست خیلی کوتاه نشون می‌دم چطور Context7 MCP رو به Open Code وصل کنیم و یه کوئری واقعی باهاش بزنیم.

مشکل: مدل‌ها از فریم‌ورک‌های جدید بی‌خبرن

فرض کن می‌خوای یه پروژه‌ی Next.js بسازی. آخرین نسخه‌ی Next.js (در زمان نوشتن این پست) نسخه‌ی 16.2 هست. ولی مدل AI تو ممکنه فقط تا نسخه‌ی 14 آپدیت باشه.

دو راه برای حل:

  1. سرچ اینترنتی — به AI بگی «برو تو گوگل آپدیت‌های جدید Next.js رو پیدا کن». این کار می‌کنه ولی کند و پر از noise (تبلیغ، تجزیه HTML، صفحه‌های loading).
  2. Context7 — یه MCP server اختصاصی که داکیومنت تمام فریم‌ورک‌های اصلی رو هاست می‌کنه و درخواست AI رو دقیق و سریع جواب می‌ده.

Context7 خیلی efficient تره چون متن خالص برمی‌گردونه — همون چیزی که AI لازم داره — نه HTML کامل سایت با ۱۰۰ تا تگ نگفتی.

نصب Context7 MCP در Open Code

این چند دقیقه طول می‌کشه:

مرحله ۱: Open Code رو باز کن

opencode

تو ترمینال. اگه نصب نداری، opencode.ai → نصب → بعد دوباره.

مرحله ۲: چک کن چه MCP داری

/mcp

اولش لیست خالیه. خوبه — می‌خوایم Context7 رو اضافه کنیم.

مرحله ۳: برو سایت Context7

context7.comInstallPick your agent

این یه نکته‌ی خوبه: Context7 برای هر agent (Claude Code، Cursor، Open Code، و…) دستور نصب اختصاصی داره. کلیک کن روی Open Code.

سه گزینه می‌بینی:

  1. MCP Server (با MCP استاندارد، MCP-ی سرور)
  2. CLI (اگه ترجیح می‌دی command line)
  3. Skill (مثل Skills که توی پست قبلی توضیح دادم)

من MCP Server رو می‌گیرم. Context7 یه دستور می‌ده — کپی، توی ترمینال پیست.

مرحله ۴: Authentication

چون Remote MCP server هست، یه browser tab باز می‌شه از تو login می‌خواد. با Google login کن. Authorize.

دقت کن: Context7 قبلاً local بود (نیازی به login نداشت). اخیراً remote شد و یه paid tier هم اضافه شد. ۱۰۰ call رایگان در حساب جدیدت داری — برای استفاده‌ی شخصی معمولاً کافیه.

مرحله ۵: تست

برگرد به Open Code، /mcp بزن — Context7 رو می‌بینی.

حالا یه کوئری واقعی:

get me the latest Next.js documentation for app router

ببین چی می‌کنه:

  1. Context7 یه search می‌زنه: next.js documentation
  2. ID داکیومنت رو می‌گیره
  3. اون داکیومنت رو fetch می‌کنه
  4. می‌فهمه آخرین ورژن مثلاً 16.2 هست
  5. اطلاعات اصلی رو میاره — همه‌ش بر اساس داده‌های امروز، نه ۶ ماه پیش

چرا این مهمه؟ مثال عملی

فرض کن می‌خوای یه پروژه‌ی Next.js Server Component بسازی. این تو نسخه‌های قبلی Next.js syntax متفاوتی داشت. اگه AI با اطلاعات قدیمی کد بزنه، خروجی کار نمی‌کنه — یا فایل ساختاری اشتباه می‌سازه، یا API های قدیمی استفاده می‌کنه.

با Context7:

Build a Next.js app with the new Server Components pattern. Use Context7 for the latest docs.

AI می‌ره Context7 رو کوئری می‌کنه، داکیومنت همین لحظه رو می‌خونه، و بر اساس اون کد می‌نویسه. کد همون اول کار می‌کنه.

نکات کاربردی

نکته ۱: نصب گیر افتاد؟ بپرس از خود AI

اگه نصب MCP‌ای گیج‌کننده شد، از خود AI بپرس. تو Open Code بگو:

how do I install context7 mcp here?

می‌ره راهنمای رسمی رو می‌خونه و قدم‌به‌قدم بهت می‌گه. این یه قابلیت کلی AI agentها هست — همیشه می‌تونی ازشون برای استفاده از خودشون کمک بگیری.

نکته ۲: Context7 برای همه‌ی فریم‌ورک‌های اصلی

نه فقط Next.js. Context7 ساپورت داره برای:

  • React, Vue, Svelte, Solid
  • Express, Nest.js, FastAPI
  • Tailwind, Bootstrap, Material UI
  • Prisma, Drizzle, TypeORM
  • Supabase, Firebase, MongoDB
  • و دهها دیگه

اگه فریم‌ورکت مشهور باشه، Context7 احتمالاً ساپورتش می‌کنه.

نکته ۳: کِی از Context7 استفاده کنیم؟

  • وقتی فریم‌ورک تو شش ماه گذشته آپدیت بزرگ داشته
  • وقتی AI داره syntax قدیمی استفاده می‌کنه
  • وقتی پروژه‌ی production می‌سازی و دقت مهمه

برای پروژه‌های ساده (Snake game، Hello World) لازم نیست — AI دانش پایه رو داره.

جمع‌بندی

  • Context7 = MCP server اختصاصی برای داکیومنت فریم‌ورک‌ها
  • حل مشکل knowledge cutoff — AI با اطلاعات همین لحظه کار می‌کنه
  • نصب سریع — Open Code + کپی یه دستور
  • رایگان تا ۱۰۰ کوئری برای استفاده‌ی شخصی
  • Multi-framework — Next.js, React, Vue, Prisma، و دهها دیگه

بعدی چیه؟

تو پست‌های بعدی این سری:

  • ساخت یه MCP server اختصاصی برای یه سرویس ایرانی (آموزش از صفر)
  • مقایسه‌ی Context7 vs alternatives (Devv، Phind)
  • Memory MCP — اضافه کردن حافظه‌ی بلندمدت به Claude

سوال داری؟ تو کامنت بپرس.


دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *