שרת MCP מאומת: MongoDB
רשימת הכלים למטה היא לכידה חיה מהשרת הרץ; קריאת כלי מאומתת עדיין ממתינה להרשאות.
התשובה הקצרה
אומת לאחרונה 2026-08-03
שרת ה-MCP של MongoDB מאפשר לעוזר AI לתשאל את מסדי הנתונים שלכם בשפה חופשית: להציג מסדי נתונים ואוספים, לתאר סכימה, להריץ find או aggregation, לספור מסמכים, לקרוא אינדקסים ולהסביר תוכנית שאילתה. זו החבילה של MongoDB עצמה, מפורסמת מארגון mongodb-js תחת רישיון Apache-2.0, והיא אחד משרתי מסדי הנתונים העמוסים ביותר בעולם ה-MCP. הרצנו אותו במקום להאמין ל-README: הפעלנו אותו עם npx על גבי stdio בדיוק כפי שמדריך ההתחלה של MongoDB מראה, ספרנו כל כלי שהתהליך הרץ מציע ושמרנו את הפלט הגולמי, כולל השגיאות המדויקות שהוא מחזיר כשמחרוזת החיבור שגויה. שני דברים שהלכידה הוכיחה ושאף README לא אומר במפורש: הדגל --readOnly המומלץ מקצר את רשימת הכלים מ-25 ל-16 ומסתיר כל כלי כתיבה, וכלי הניהול של Atlas לא מופיעים כלל בלי אישורי API של Atlas. שתי הספירות שלנו, מאותה ריצה. [1][3][6]
אימות
השיטה
הרצנו את השרת עם npx על גבי stdio לפי הדוגמה של MongoDB עצמה עם --readOnly, השלמנו את לחיצת היד של MCP בגרסת פרוטוקול 2025-06-18, קראנו ל-tools/list והרצנו קריאת כלי אמיתית אחת. טבלת הכלים למטה היא התשובה הזו, מילה במילה. על ה-Mac הזה לא רץ שרת MongoDB ואין Docker, וגם אשכול Atlas לא היה זמין, ולכן הגדרנו את MDB_MCP_CONNECTION_STRING לכתובת דמה גלויה לעין: מספיק כדי להפעיל את השרת ולספור מה הוא מציע, לא מספיק כדי להגיע למסד נתונים. קריאת הכלי היחידה חזרה עם שגיאת החיבור של השרת עצמו, המודפסת למטה, ולכן קריאה מאומתת עדיין ממתינה להרשאות. באותה ריצה הרצנו עוד שש בדיקות כדי ללכוד את השגיאות בקטע פתרון התקלות. שימו לב שהשרת הזה לא מדפיס דבר ל-stderr בהפעלה: הודעת הפתיחה למטה הגיעה על גבי MCP כ-notifications/message, שם נמצא היומן שלו.
הודעת הפתיחה של השרת
[server]: Detected a MongoDB connection string in the configuration, trying to connect...
[server]: Server with version 1.14.0 started with transport StdioServerTransport and agent runner {"name":"getroutines-mcp-verifier","version":"1.0.0","title":"unknown"}קריאת כלי אמיתית אחת
tools/call list-databases {}The configured connection string is not valid. Please check the connection string and confirm it points to a valid MongoDB instance.
שורות אמיתיות מהתוצאה שנלכדה: מספיק כדי להוכיח שהקריאה נענתה.
כלים
השרת ענה ל-tools/list עם 16 כלים בתאריך 2026-08-03. השמות, התיאורים והפרמטרים למטה הם המילים שלו עצמו, מועתקים מהתשובה הזו וללא עריכה.
| כלי | מה הוא עושה |
|---|---|
| aggregate-dbdatabase*pipeline*responseBytesLimit | Run an aggregation against a MongoDB database |
| aggregatedatabase*collection*pipeline*responseBytesLimit | Run an aggregation against a MongoDB collection |
| collection-indexesdatabase*collection* | Describe the indexes for a collection |
| collection-schemadatabase*collection*sampleSizeresponseBytesLimit | Describe the schema for a collection |
| collection-storage-sizedatabase*collection* | Gets the size of the collection |
| connectconnectionString* | Connect to a MongoDB instance. The config resource captures if the server is already connected to a MongoDB cluster. If the user has configured a connection string or has previously called the connect tool, a connection is already established and there's no need to call this tool unless the user has explicitly requested to switch to a new MongoDB cluster. |
| countdatabase*collection*query | Gets the number of documents in a MongoDB collection using db.collection.count() and query as an optional filter parameter |
| db-statsdatabase* | Returns statistics that reflect the use state of a single database |
| explaindatabase*collection*method*verbosity | Returns statistics describing the execution of the winning plan chosen by the query optimizer for the evaluated method |
| exportdatabase*collection*exportTitle*exportTarget*jsonExportFormat | Export a query or aggregation results in the specified EJSON format. |
| finddatabase*collection*filterprojectionlimitsortresponseBytesLimit | Run a find query against a MongoDB collection |
| list-collectionsdatabase* | List all collections for a given database |
| list-databases | List all databases for a MongoDB connection |
| mongodb-logstypelimit | Returns the most recent logged mongod events |
| list-knowledge-sources | List available data sources in the MongoDB Assistant knowledge base. Use this to explore available data sources or to find search filter parameters to use in search-knowledge. |
| search-knowledgequery*limitdataSources | Search for information in the MongoDB Assistant knowledge base. This includes official documentation, curated expert guidance, and other resources provided by MongoDB. Supports filtering by data source and version. |
פרמטרים המסומנים ב-* הם חובה.
התקנה
העתיקו את הבלוק של האפליקציה שלכם. כל אחד מהם הוא ההגדרה המדויקת שאיתה אימתנו את השרת.
פתחו את הקובץ ~/Library/Application Support/Claude/claude_desktop_config.json (בתוך Claude Desktop: Settings, אחר כך Developer, אחר כך Edit Config) והוסיפו:
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server@latest",
"--readOnly"
],
"env": {
"MDB_MCP_CONNECTION_STRING": "mongodb+srv://user:pass@cluster.mongodb.net/myDatabase"
}
}
}
}הדביקו את מחרוזת החיבור שלכם, ואז סגרו ופתחו מחדש את Claude Desktop. השאירו את הדגל --readOnly: MongoDB מציגה אותו בכל דוגמה, והוא מה שמונע מעוזר AI לכתוב לנתונים שלכם. זו בדיוק הצורה שאותה אימתנו, ומחרוזת החיבור למעלה היא הדמה שאיתה הפעלנו את השרת. [8][6]
פקודה אחת בטרמינל:
claude mcp add --env MDB_MCP_CONNECTION_STRING="mongodb+srv://user:pass@cluster.mongodb.net/myDatabase" --transport stdio mongodb -- npx -y mongodb-mcp-server@latest --readOnly
כל מה שאחרי המקף הכפול הוא הפקודה המדויקת ש-Claude Code יריץ. הדגל --transport יושב בין זוג ה---env לבין שם השרת בכוונה: שם שמופיע מיד אחרי --env נקרא כזוג KEY=value נוסף ונדחה. [9]
הוסיפו ל-~/.cursor/mcp.json עבור כל הפרויקטים, או ל-.cursor/mcp.json בתוך פרויקט אחד:
{
"mcpServers": {
"MongoDB": {
"command": "npx",
"args": [
"-y",
"mongodb-mcp-server@latest",
"--readOnly"
],
"env": {
"MDB_MCP_CONNECTION_STRING": "mongodb+srv://user:pass@cluster.mongodb.net/myDatabase"
}
}
}
}Cursor קורא את הקובץ מחדש אחרי הפעלה מחדש. כפתור ההתקנה בלחיצה אחת שב-README של MongoDB מגדיר את הפקודה אבל לא את מחרוזת החיבור, ולכן בכל מקרה תוסיפו את בלוק ה-env בעצמכם. התייחסו לקובץ הזה כמו לכל קובץ שמכיל סיסמה למסד נתונים: זה טקסט גלוי על הדיסק, לכן שמרו אותו מחוץ למאגר קוד שאתם דוחפים. [10][6]
בלי קובץ JSON ובלי טרמינל. ב-Routines: Settings, אחר כך Assistant, אחר כך Connections, אחר כך Add MCP Server. העבירו את הטופס ל-Command (stdio) והזינו:
Name MongoDB Command npx Arguments -y mongodb-mcp-server@latest --readOnly Environment Variables MDB_MCP_CONNECTION_STRING mongodb+srv://user:pass@cluster.mongodb.net/myDatabase
הערך בשדה ה-Arguments מתפצל לפי רווחים, לכן השאירו בדיוק את שלוש המילים האלה. מחרוזת החיבור מכילה סיסמה, ולכן היא נכנסת ל-Environment Variables ולעולם לא ל-Arguments. לחצו קודם על Test Connection: עם --readOnly שרת תקין עונה עם שישה עשר כלים. [11][6]
בלי טרמינל
אם מעולם לא פתחתם את הטרמינל ואין לכם כוונה להתחיל, זה המסלול שלכם. Routines היא אפליקציית Mac שמריצה שרתי MCP בשבילכם: ממלאים כמה שדות פעם אחת, והכלים של השרת זמינים ל-AI שלכם בצ׳אט ובשגרות מתוזמנות. הדבר היחיד שצריך להביא מראש הוא מחרוזת חיבור ל-MongoDB.
01
הורידו את האפליקציה מ-getroutines.ai/download, גררו אותה ל-Applications והתחברו.
02
ב-Atlas פתחו את האשכול, לחצו Connect, בחרו Drivers והעתיקו את המחרוזת שמתחילה ב-mongodb+srv://. החליפו את סיסמת הדמה בסיסמה האמיתית של אותו משתמש מסד נתונים. אם מסד הנתונים רץ על ה-Mac הזה, המחרוזת היא בדרך כלל mongodb://localhost:27017/yourDatabase. אם אפשר, תנו למשתמש הרשאות קריאה בלבד: העמוד הזה משתמש בהגדרת הקריאה בלבד לכל אורכו.
03
חזרה ב-Routines, לחצו על החשבון שלכם בתחתית סרגל הצד ובחרו Settings. פתחו את הקטע Assistant, אחר כך את הלשונית Connections, גללו אל MCP Servers ולחצו על Add MCP Server.
04
הטופס נפתח במצב URL (SSE/HTTP). העבירו אותו ל-Command (stdio): השרת הזה הוא פקודה, לא כתובת אינטרנט. Name: MongoDB. Command: npx. Arguments: -y mongodb-mcp-server@latest --readOnly, בדיוק שלוש המילים האלה.
05
ב-Environment Variables הוסיפו את MDB_MCP_CONNECTION_STRING עם המחרוזת שהעתקתם. לחצו Test Connection: Routines מפעילה את השרת בלי לשמור אותו ומדווחת כמה כלים היא מצאה, שישה עשר עם --readOnly. אחר כך לחצו Add Server.
06
הכלים עובדים בצ׳אט מיד: שאלו אילו אוספים קיימים, או איך נראה מסמך טיפוסי. כדי לתת לשגרה מתוזמנת להשתמש בהם, פתחו את השגרה, מצאו את הכרטיס Tools & connections וסמנו את השרת תחת Apps.
רעיונות לשגרות
אחרי שהשרת מחובר, שגרה מתוזמנת יכולה להשתמש בכלים שלו גם כשאתם לא מול המסך. העתיקו פרומפט, הדביקו אותו ב-Routines ובחרו שעה. הפרומפטים כתובים באנגלית בכוונה, מדביקים אותם בדיוק כפי שהם.
Every Monday at 9:00, count the documents in every collection in my production database, compare the counts with the ones in data-health.md from last week, and rewrite that file with this week's numbers and a note on anything that moved more than 20 percent.
Every weekday at 8:00, find the users created in the last 24 hours in my app database, group them by signup source and plan, and save the counts with a one-line comment as signups.md in my Notes folder.
Every Friday at 15:00, list the indexes on my orders collection, run explain on the three queries I use most, and write anything that is doing a full collection scan to index-review.md with the query that caused it.
פתרון תקלות
שגיאות אמיתיות שנלכדו בריצת האימות, מודפסות בדיוק כפי שהשרת החזיר אותן.
מה רואים
[server]: Failed to connect to MongoDB instance using the connection string from the config: querySrv ENOTFOUND _mongodb._tcp.cluster0.placeholder.mongodb.net
הפתרון
השורה הזו היא היומן של השרת עצמו, שנשלח על גבי MCP כ-notifications/message ולא מודפס ל-stderr. קריאת הכלי עצמה מחזירה מחרוזת אחרת: The configured connection string is not valid. Please check the connection string and confirm it points to a valid MongoDB instance. השרת מתחבר בעצלתיים, ולכן מחרוזת חיבור שגויה לא מונעת ממנו לעלות או להציג את הכלים שלו; מגלים את זה רק בקריאה האמיתית הראשונה. זה בדיוק מה שהריצה שלנו הפיקה, כי הפעלנו אותו בכוונה עם כתובת דמה. שגיאת ENOTFOUND על שם שמתחיל ב-_mongodb._tcp פירושה ששם המארח של mongodb+srv:// לא נפתר, לכן בדקו את כתובת האשכול ובדקו שהרשת שלכם מגיעה אליה. סיסמה שגויה מחזירה הודעה אחרת, שגיאת אימות ולא שגיאת DNS.
מה רואים
You need to connect to a MongoDB instance before you can access its data.
הפתרון
הפעלתם את השרת בלי מחרוזת חיבור כלל, וזה מותר: הוא עולה ומציג את כל הכלים שלו בכל מקרה. או שתגדירו את MDB_MCP_CONNECTION_STRING (בבלוק ה-env, או ב-Environment Variables ב-Routines) ותפעילו מחדש, או שתבקשו מהעוזר לקרוא לכלי connect עם מחרוזת חיבור עבור המפגש הנוכחי בלבד.
מה רואים
[server]: Failed to connect to MongoDB instance using the connection string from the config: connect ECONNREFUSED <ip address>:27017
הפתרון
הכתובת נפתרה אבל שום דבר לא מאזין בפורט 27017, וזו התשובה של Mac שלא רץ עליו MongoDB מקומי. הפעילו קודם את ה-mongod המקומי או את מכולת ה-Docker שלכם, או כוונו את מחרוזת החיבור לאשכול ה-Atlas שלכם. השרת מסתיר את הכתובת בעצמו, ולכן ההודעה מציגה <ip address> ולא מספר.
מה רואים
MCP error -32602: Tool drop-database not found
הפתרון
זה הדגל --readOnly עושה את עבודתו. כשהדגל דולק השרת מפרסם 16 כלים וכל כלי יצירה, עדכון ומחיקה נעדר, כך שהעוזר אפילו לא רואה אותם; באותה ריצה ספרנו 25 כלים כשהדגל הוסר. אם אתם באמת צריכים כתיבה, הסירו את --readOnly מהארגומנטים והפעילו מחדש, ודעו שבדיוק נתתם לעוזר AI גישה ל-delete-many ול-drop-collection.
מה רואים
MCP error -32602: Tool atlas-list-projects not found
הפתרון
כלי הניהול של Atlas נרשמים רק כשקיימים אישורי API של Atlas. הגדירו את MDB_MCP_API_CLIENT_ID ואת MDB_MCP_API_CLIENT_SECRET מתוך Atlas Service Account והפעילו מחדש את השרת, והם יופיעו לצד כלי מסד הנתונים. לריצה שלנו לא היו כאלה, ולכן הטבלה בעמוד הזה היא צד מסד הנתונים בלבד.
מה רואים
MCP error -32602: Input validation error: Invalid arguments for tool find: Invalid input: expected string, received undefined at database Invalid input: expected string, received undefined at collection
הפתרון
העוזר קרא ל-find בלי לציין מסד נתונים ואוסף, ושניהם חובה. בדרך כלל זה סימן שהמודל מנחש את מבנה הנתונים שלכם: בקשו ממנו להריץ קודם list-databases ו-list-collections, ואז לחזור על השאלה. גרמנו לשגיאה הזו בכוונה כששלחנו find בלי ארגומנטים.
הפתרון
הפקודה npx שייכת ל-Node.js. אם Node לא מותקן על ה-Mac, כל לקוח בעמוד הזה ייכשל בשלב ההפעלה עוד לפני שהשרת מספיק לומר משהו. התקינו Node מ-nodejs.org, הפעילו מחדש את לקוח ה-MCP ונסו שוב.
שאלות נפוצות
זו תוכנה קטנה של MongoDB שיושבת בין עוזר AI לבין מסדי הנתונים שלכם ומדברת Model Context Protocol. אחרי החיבור, עוזר כמו Claude יכול להציג מסדי נתונים ואוספים, לתאר סכימה ואינדקסים של אוסף, להריץ שאילתות find ו-aggregation, לספור מסמכים, לקרוא אירועי mongod אחרונים ולהסביר תוכנית שאילתה. הוא רץ כתהליך מקומי על ה-Mac שלכם ומדבר עם אפליקציית ה-AI על גבי stdio, או על גבי Streamable HTTP אם תבחרו בכך. [6][3]
כשמפעילים אותו כפי ש-MongoDB ממליצה, עם --readOnly, השרת הרץ חושף 16 כלים: תשאול (find, aggregate, aggregate-db, count, explain, export), מבנה (list-databases, list-collections, collection-schema, collection-indexes, collection-storage-size, db-stats, mongodb-logs), החיבור עצמו (connect) ועוזר התיעוד של MongoDB (search-knowledge, list-knowledge-sources). הטבלה למעלה היא פלט ה-tools/list החי, מילה במילה. אם מסירים את --readOnly אותו שרת מפרסם 25: תשעת הנוספים הם create-collection, create-index, insert-many, update-many, delete-many, drop-collection, drop-database, drop-index ו-rename-collection. שתי הספירות מהריצה שלנו.
הוא דורש מחרוזת חיבור ל-MongoDB, לא מפתח API: MDB_MCP_CONNECTION_STRING, שמצביעה על מסד נתונים על ה-Mac שלכם או על אשכול Atlas. כלי הניהול של Atlas הם עניין נפרד ודורשים Atlas Service Account, כלומר MDB_MCP_API_CLIENT_ID ו-MDB_MCP_API_CLIENT_SECRET. אף אחד מהם אינו נדרש כדי להפעיל את השרת: הוא עולה ומציג את הכלים שלו גם בלי הגדרות, ונכשל רק כשכלי באמת צריך את מסד הנתונים. [6]
ברירות המחדל זהירות, ושלוש מהן שוות ידיעה. כל דוגמה ש-MongoDB מפרסמת כוללת --readOnly, ואימתנו שהוא מסיר את תשעת כלי הכתיבה מהרשימה ולא רק חוסם אותם. אופרטורים של JavaScript בצד השרת כמו $where ו-$function מושבתים כברירת מחדל. הכלים ההרסניים שכן קיימים מבקשים אישור רק אם הלקוח שלכם תומך ב-elicitation של MCP, כך שלקוח בלי תמיכה עלול להריץ אותם ישירות. עוד שני דברים לשקול: איסוף טלמטריה פעיל כברירת מחדל וההגדרה MDB_MCP_TELEMETRY=disabled מכבה אותו, וראינו את השרת הרץ שולח אירועי טלמטריה במהלך הלכידה שלנו. ערוץ ה-HTTP הוא בבחירה, ו-MongoDB עצמה אומרת שהוא אינו בטוח לייצור בלי שכבת אימות משלכם. השליטה החזקה ביותר היא עדיין מחרוזת החיבור: תנו לעוזר משתמש מסד נתונים עם הרשאות קריאה בלבד. [6]
לא. ב-Routines ממלאים את השדות בהגדרות ולוחצים Test Connection; המדריך למעלה מראה כל לחיצה, כולל לאן נכנסת מחרוזת החיבור. Claude Desktop דורש עריכה חד-פעמית של קובץ JSON קטן. רק Claude Code הוא כלי טרמינל מטבעו. [11][8]
ביום שבו הרצנו את זה, npm הגיש את 1.14.0 כגרסה האחרונה, שפורסמה ב-2026-07-14, וזו הגרסה שהעמוד הזה מתאר. הענף הראשי של הפרויקט כבר מציג 2.0.0, לאחר קומיט שחרור שמוזג ב-2026-07-31 ועדיין לא הגיע ל-npm, כך ששחרור 2.x קרוב ו-mongodb-mcp-server@latest יאסוף אותו ברגע שינחת. זו הסיבה לנעוץ גרסה מדויקת בכל דבר שאתם סומכים עליו במקום לסמוך על @latest: פורסמו 78 גרסאות, כולל ערוצי alpha ו-prerelease. [1][4][5]
כל לקוח MCP שמסוגל להפעיל שרת stdio מקומי: Claude Desktop, Claude Code, Cursor ו-Routines כולם יכולים, וההגדרה המדויקת לכל אחד נמצאת למעלה. ה-README של MongoDB מתעד גם את VS Code, Windsurf, GitHub Copilot CLI ו-OpenCode, ולצדם תמונת Docker רשמית אם אתם מעדיפים לא להשתמש ב-npx. השרת זהה בכל מקום; רק המקום שבו מדביקים את ההגדרה משתנה. היזהרו מחבילות קהילה בעלות שם דומה ב-npm, כמו @pash1986/mongodb-mcp-server או @harryelv/mongodb-mcp-server: אף אחת מהן אינה של MongoDB, והחבילה הרשמית היא פשוט mongodb-mcp-server. [6][1][7]
מקורות
כל מה שבעמוד הזה שלא ראינו בעצמנו בריצה מקושר כאן, עם התאריך שבו קראנו אותו. לגבי השאר, הריצה עצמה היא הקבלה.
[1]
Latest version 1.14.0, published 2026-07-14, license Apache-2.0, repository mongodb-js/mongodb-mcp-server. 78 published versions across the latest, pre, prerelease and alpha channels.
[2]
[3]
1,091 stars, Apache-2.0, not archived, last push 2026-07-31, created 2025-04-04, per the GitHub API.
[4]
The version field on main reads 2.0.0, ahead of the 1.14.0 that npm serves as latest.
[5]
Merged 2026-07-31; the commit says the new version will be published to npm once merged, which had not happened at access time.
[6]
Quick Start configs, the safety notice that every example ships --readOnly, the full MDB_MCP_ option table including READ_ONLY, TELEMETRY, DISABLE_SERVER_SIDE_JS and CONFIRMATION_REQUIRED_TOOLS, the Docker image, and the HTTP transport warning.
[7]
Community lookalikes with no MongoDB affiliation: @pash1986/mongodb-mcp-server, @harryelv/mongodb-mcp-server, @henrik3/mongodb-mcp-server, mongo-mongoose-mcp, @krazor/mongodb-mcp, @iflow-mcp/mongodb-mcp-server.
[8]
The Claude Desktop config file location and the mcpServers shape, linked from this server's README.
[9]
The claude mcp add syntax for local stdio servers, the --env flag, and the warning about placing the server name straight after --env.
[10]
The mcp.json shape and the two file locations, ~/.cursor/mcp.json and .cursor/mcp.json.
[11]
How Routines runs one-click OAuth connectors and any MCP server.
העמוד הזה מתאר את MongoDB כפי שהתנהג בריצה מתוארכת אחת על Mac אחד. גרסאות משתנות: אם משהו כאן כבר לא תואם למה שאתם רואים, תאריך הלכידה בראש העמוד אומר בן כמה הצילום.
מאחורי המדריך הזה
Routines, האפליקציה שמאחורי המדריך הזה, מריצה שרתי MCP כמו זה בלי טרמינל: כך עובדים המחברים. הדוחות שהיא כותבת נשארים קובצי markdown על ה-Mac שלכם, ואין חשבון ענן לשלם. להורדת Routines