שרת MCP מאומת: Context7
התשובה הקצרה
אומת לאחרונה 2026-08-03
Context7 מאתר תיעוד עדכני ודוגמאות קוד עבור ספריה מסוימת, כולל לפי גרסה, ומעביר אותם לעוזר ה-AI שלכם כדי שיפסיק לענות מתוך זיכרון שיכול להיות בן שנה. הוא נבנה ומפורסם על ידי Upstash, החברה שמאחורי השירות Context7, ועל ה-Mac שלכם הוא רץ כפקודה קטנה אחת. מפתח API הוא רשות כאן: התיעוד מציע מפתח למכסות גבוהות יותר ולמאגרים פרטיים, ואנחנו לא השתמשנו באחד. הרצנו את השרת, דיברנו איתו בפרוטוקול, ספרנו את שני הכלים שהוא חושף, ואז שאלנו אותו על React בלי שום מפתח. הוא החזיר רשימה אמיתית ומדורגת של מקורות תיעוד ל-React, והפלט הגולמי הזה נמצא בעמוד הזה. [1][3][5]
אימות
השיטה
הרצנו את השרת עם npx על גבי stdio, השלמנו את לחיצת היד של MCP וקראנו ל-tools/list, שהחזיר שני כלים. אחר כך ביצענו קריאת כלי אמיתית אחת, resolve-library-id עבור React, בלי שום מפתח API ובלי הרשמה לשום דבר. חזרה רשימה מדורגת של מזהי ספריות של Context7 עבור React, והקטע למטה הוא פתיחת התשובה הזו, מילה במילה.
הודעת הפתיחה של השרת
Context7 Documentation MCP Server v3.2.5 running on stdio
קריאת כלי אמיתית אחת
tools/call resolve-library-id {"libraryName":"React","query":"how to use hooks"}Available Libraries: - Title: React - Context7-compatible library ID: /reactjs/react.dev
שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.
כלים
השרת ענה ל-tools/list עם 2 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.
| כלי | מה הוא עושה |
|---|---|
| resolve-library-idquery*libraryName* | Resolves a package/product name to a Context7-compatible library ID and returns matching libraries. You MUST call this function before 'Query Documentation' tool to obtain a valid Context7-compatible library ID UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query. Each result includes: - Library ID: Context7-compatible identifier (format: /org/project) - Name: Library or package name - Description: Short summary - Code Snippets: Number of available code examples - Source Reputation: Authority indicator (High, Medium, Low, or Unknown) - Benchmark Score: Quality indicator (100 is the highest score) - Versions: List of versions if available. Use one of those versions if the user provides a version in their query. The format of the version is /org/project/version. For best results, select libraries based on name match, source reputation, snippet coverage, benchmark score, and relevance to your use case. Selection Process: 1. Analyze the query to understand what library/package the user is looking for 2. Return the most relevant match based on: - Name similarity to the query (exact matches prioritized) - Description relevance to the query's intent - Documentation coverage (prioritize libraries with higher Code Snippet counts) - Source reputation (consider libraries with High or Medium reputation more authoritative) - Benchmark Score: Quality indicator (100 is the highest score) Response Format: - Return the selected library ID in a clearly marked section - Provide a brief explanation for why this library was chosen - If multiple good matches exist, acknowledge this but proceed with the most relevant one - If no good matches exist, clearly state this and suggest query refinements For ambiguous queries, request clarification before proceeding with a best-guess match. IMPORTANT: Do not call this tool more than 3 times per question. If you cannot find what you need after 3 calls, use the best result you have. |
| query-docslibraryId*query* | Retrieves and queries up-to-date documentation and code examples from Context7 for any programming library or framework. You must call 'Resolve Context7 Library ID' tool first to obtain the exact Context7-compatible library ID required to use this tool, UNLESS the user explicitly provides a library ID in the format '/org/project' or '/org/project/version' in their query. Do not call this tool more than 3 times per question. |
פרמטרים המסומנים ב-* הם חובה.
התקנה
העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.
פתחו את הקובץ ~/Library/Application Support/Claude/claude_desktop_config.json (בתוך Claude Desktop: Settings, אחר כך Developer, אחר כך Edit Config) והוסיפו:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": [
"-y",
"@upstash/context7-mcp"
]
}
}
}זו בדיוק ההגדרה שאימתנו, בלי שום מפתח. אם תרצו בהמשך מפתח API של Context7, הדרך המתועדת להעביר אותו היא בלוק env עם CONTEXT7_API_KEY לצד השדה args. סגרו ופתחו מחדש את Claude Desktop אחרי השמירה. [6][5]
פקודה אחת בטרמינל:
claude mcp add context7 -- npx -y @upstash/context7-mcp
כל מה שאחרי המקף הכפול הוא הפקודה המדויקת ש-Claude Code יריץ, וזו הפקודה שאנחנו הרצנו. הדרך המתועדת להוסיף מפתח בהמשך היא --api-key ואחריו המפתח, בסוף אותה שורה. [7][5]
הוסיפו ל-~/.cursor/mcp.json עבור כל הפרויקטים, או ל-.cursor/mcp.json בתוך פרויקט אחד:
{
"mcpServers": {
"context7": {
"command": "npx",
"args": [
"-y",
"@upstash/context7-mcp"
]
}
}
}Cursor קורא את הקובץ מחדש אחרי הפעלה מחדש. [8]
בלי קובץ JSON ובלי טרמינל. ב-Routines: Settings, אחר כך Assistant, אחר כך Connections, אחר כך Add MCP Server. העבירו את הטופס ל-Command (stdio) והזינו:
Name Context7 Command npx Arguments -y @upstash/context7-mcp
השאירו את Environment Variables ריק: כך הרצנו אותו, והוא לא צריך שם כלום. לחצו קודם על Test Connection: שרת תקין עונה עם מספר הכלים שלו. [9]
בלי טרמינל
אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים שלושה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות.
01
הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.
02
לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.
03
העבירו את הטופס ל-Command (stdio). השרת הזה הוא פקודה שה-Mac שלכם מריץ, לא כתובת אינטרנט, ולכן האפשרות השניה לא תעבוד עבורו.
04
Name: Context7. Command: npx. Arguments: -y @upstash/context7-mcp. זו כל ההגדרה, והיא בדיוק זו שאימתנו. אין למה להירשם ואין מה להדביק.
05
השאירו את Environment Variables ריק, השרת הזה לא צריך משתנים. לחצו Test Connection: Routines מפעילה את השרת ומדווחת כמה כלים היא מצאה, שניים עבור השרת הזה. אחר כך לחצו Add Server.
06
הכלים עובדים בצ׳אט מיד: נקבו בשם הספריה ובקשו את התיעוד העדכני שלה. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.
רעיונות לשגרות
אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.
Every Monday at 9:00, look up the current documentation for React, Tailwind CSS and Laravel, note anything that reads as new or changed since last week, and save a short plain-English summary as stack-briefing.md in my Documents folder.
On the first Monday of every month at 10:00, read the library names listed in my stack.md file, fetch the current upgrade and migration documentation for each one, and write me a checklist of what would need to change, one short section per library.
Every Friday at 15:00, take the libraries listed in my learning.md file, pull their current setup and configuration documentation, and save one short cheat sheet per library in my Notes folder with the code examples included.
פתרון תקלות
שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.
הפתרון
שום דבר לא שבור. שני הכלים רצים רק כשהעוזר מחליט להשתמש בהם, ולכן אמרו בפירוש מה אתם רוצים: נקבו בשם הספריה ובקשו ממנו לבדוק את התיעוד העדכני לפני שהוא עונה. אם האפליקציה שלכם מציגה את שני הכלים שבטבלה למעלה אחרי החיבור, השרת עובד וכל השאר הוא ניסוח הבקשה.
הפתרון
החיפוש מתבסס על השם הרשמי, והשרת מבקש אותו עם סימני הפיסוק המדויקים, כלומר Next.js ולא nextjs. בריצה שלנו, בקשה עבור React לבדה החזירה חמש רשומות שונות, לכל אחת מזהה ספריה משלה, מספר קטעי קוד וציון איכות. אם הרשומה הראשונה אינה התיעוד שהתכוונתם אליו, בקשו במפורש אחת מהאחרות שברשימה לפי שמה.
הפתרון
השרת הזה הוא שירות חיפוש, לא עותק של התיעוד על הדיסק שלכם. תיאורי הפרמטרים שלו עצמו, שנלכדו בריצת האימות שלנו, אומרים שהשאילתה נשלחת ל-Context7 API לעיבוד, ולכן שני הכלים זקוקים לחיבור אינטרנט כדי לענות. ברשת ארגונית סגורה, בקשו ממי שמנהל אותה לאפשר גישה לשירות Context7.
הפתרון
הפקודה npx שייכת ל-Node.js. אם Node לא מותקן על ה-Mac, כל לקוח בעמוד הזה ייכשל בשלב ההפעלה עוד לפני שהשרת מספיק לומר משהו. התקינו Node מ-nodejs.org, הפעילו מחדש את לקוח ה-MCP ונסו שוב.
שאלות נפוצות
זהו שרת לחיפוש תיעוד עבור עוזרי AI, שמפורסם על ידי Upstash. אחרי החיבור, העוזר שלכם יכול למשוך תיעוד עדכני ודוגמאות קוד לספריה מסוימת, כולל לפי גרסה, במקום לענות מתוך נתוני אימון שיכולים להקדים את הגרסה שאתם משתמשים בה. הוא רץ כתהליך מקומי על ה-Mac שלכם ומדבר עם אפליקציית ה-AI על גבי stdio. [5][3]
שניים, והם נועדו לשימוש לפי הסדר: resolve-library-id הופך שם כמו React למזהה ספריה של Context7 ומציג את ההתאמות שנמצאו, ואחריו query-docs מושך תיעוד ודוגמאות קוד עבור המזהה שבחרתם. הטבלה למעלה היא פלט ה-tools/list החי, מילה במילה, כולל ההערה של השרת עצמו שאין לקרוא לאף אחד מהם יותר משלוש פעמים לשאלה.
הוא לא קורא כלום על ה-Mac שלכם: אין לו גישה לקבצים, לתיקיות או למעטפת, ושני הכלים רק מחפשים תיעוד. התמורה היא בכיוון ההפוך. הטקסט שאתם שולחים יוצא החוצה: תיאורי הפרמטרים של השרת עצמו, שנלכדו בריצת האימות שלנו, אומרים שהשאילתה נשלחת ל-Context7 API לעיבוד ומזהירים מפני הכללת מפתחות API, אישורי גישה, מידע אישי או קוד קנייני בתוכה. שאלו אותו על ספריות, לא על הקוד הפרטי שלכם.
לא. ב-Routines ממלאים שלושה שדות בהגדרות ולוחצים Test Connection; המדריך למעלה מראה כל לחיצה. Claude Desktop דורש עריכה חד-פעמית של קובץ JSON קטן. רק Claude Code הוא כלי טרמינל מטבעו. [9][6]
לא כדי להתחיל. בריצה שלנו לא היה מפתח בשום מקום וקריאת הדוגמה עדיין החזירה תוצאות אמיתיות, ולכן בלוקי ההגדרה למעלה לא כוללים מפתח. התיעוד אכן מציע מפתח חינמי מלוח הבקרה של Context7 למכסות גבוהות יותר ולגישה למאגרים פרטיים, שמועבר בדגל --api-key או במשתנה הסביבה CONTEXT7_API_KEY. הוסיפו אותו אם נתקלתם במגבלה, לא לפני כן. [5]
כי מסמכי התיעוד סותרים זה את זה, וגם את החבילה עצמה. ה-README שפורסם עם חבילת ה-npm מציין את resolve-library-id ואת get-library-docs, בעוד שה-README במאגר מציין את resolve-library-id ואת query-docs. הגרסה שאנחנו באמת הרצנו, 3.2.5, החזירה ב-tools/list את resolve-library-id ואת query-docs, ולכן אלה שני השמות בטבלה למעלה. אם מדריך מזכיר כלי שהאפליקציה שלכם לא מציגה, לכו לפי האפליקציה. [5][4]
כל לקוח MCP שמסוגל להפעיל שרת stdio מקומי: Claude Desktop, Claude Code, Cursor ו-Routines כולם יכולים, וההגדרה המדויקת לכל אחד נמצאת למעלה. Upstash גם מפעילה גרסה מתארחת של אותו שרת בכתובת אינטרנט, עבור לקוחות שמעדיפים כתובת על פני פקודה, והיא מתועדת לצד ההתקנה המקומית. [6][7][8][9][5]
מקורות
כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.
[1]
Latest version 3.2.5, published 2026-07-25; publisher and maintainers are Upstash accounts.
[2]
[3]
60,170 stars, MIT license and a push dated 2026-08-02 at access time.
[4]
The repository README, which names the tools resolve-library-id and query-docs.
[5]
Read from the npm registry payload: per-client install blocks, the stdio and http transport flags, the optional API key, and the hosted server address.
[6]
The official Claude Desktop quickstart and the location of its config file.
[7]
[8]
[9]
How Routines runs one-click OAuth connectors and any MCP server.
העמוד הזה מתאר את Context7 כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.
מאחורי המדריך הזה
Routines, האפליקציה שמאחורי המדריך הזה, מריצה שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. הפתקים שלכם נשארים קובצי markdown על ה-Mac שלכם, אין חשבון ענן לשלם, והיא עובדת גם בלי אינטרנט. להורדת Routines