Когда звать
- Когда нужна структура коллекций или план запроса MongoDB без изменений в базе.
- Когда требуется отдельно оценить права на MongoDB Atlas, соединение с базой и сохранение экспортов.
Коллекции, индексы и Atlas
MongoDB MCP Server опубликован в mongodb-js/mongodb-mcp-server. В метаданных пакета автором указана MongoDB с адресом в домене компании. Репозиторий относится к официальным инструментам MongoDB, хотя имя организации отличается от простого mongodb. В этой карточке описан пакет сервера, а не сторонняя обёртка с похожим названием.
Сервер может перечислять базы и коллекции, описывать схему, показывать индексы, выполнять поиск и агрегации. Инструмент explain помогает изучить план запроса. Отдельные возможности Atlas читают сведения о проектах и кластерах, но полный набор также способен создавать ресурсы и менять конфигурацию. Доступ к данным коллекции и управление Atlas нужно оценивать раздельно.
Настройка без лишнего доступа
Для прямой базы README предлагает MDB_MCP_CONNECTION_STRING; её передают через окружение. Для Atlas API предусмотрены MDB_MCP_API_CLIENT_ID и MDB_MCP_API_CLIENT_SECRET. Если задача состоит только в чтении одной базы по строке подключения, выдавать полномочия управления всей организацией Atlas не требуется.
Стандартный транспорт - stdio. Есть HTTP-вариант, однако CLI рассчитан на одного пользователя в локальном или закрытом окружении. Встроенной аутентификации клиентов он не предоставляет. Сам факт, что порт открыт и отвечает, не делает его подходящим общим сервером для команды. Для такого размещения нужны отдельная проверка личности и изоляция подключений.
Включите --readOnly или MDB_MCP_READ_ONLY=true. Несмотря на безопасные примеры README, значение настройки по умолчанию - false. Режим исключает инструменты создания, изменения и удаления, но его нужно подкрепить пользователем базы с правами чтения. Списки отключённых инструментов помогают убрать лишние категории.
Первая проверка структуры
Попросите: «В указанной тестовой базе перечисли коллекции и опиши поля одной выбранной коллекции. Покажи её индексы. Не выводи документы с личными сведениями, не выполняй экспорт, вставку, удаление и агрегации с записью». Это проверка структуры без копирования массива клиентских данных в контекст.
Для последующих запросов есть indexCheck: он отклоняет операции, которые обходят коллекцию без индекса. Это ограничение производительности, а не замена разрешений. Тяжёлое чтение способно нагружать базу даже без изменения записей, поэтому важны фильтры и небольшие результаты.
README отдельно предупреждает о журналах и экспорте: они записываются локально и могут содержать чувствительные данные. Перед экспортом отдельно проверьте, доступен ли он при readOnly, и какой каталог используется для файлов. Apache-2.0 лицензирует код MCP, но не отменяет условия MongoDB Atlas и права на содержимое коллекций. На 23 октября 2026 года прочитаны README, LICENSE и версия пакета с пометкой предварительного выпуска. Установку и реальные вызовы не проводили.
Паспорт проверки
Сверено с первоисточником . Версия и условия могут измениться, перед установкой откройте первоисточник.
- Версия
- 3.1.1-pre.1 (packages/mongodb-mcp-server/package.json, предварительная версия) (коммит
7af9f52) - Подключение
- Локальный stdio по умолчанию; HTTP возможен, но CLI рассчитан на одного пользователя без встроенной аутентификации клиентов.
- Лицензия
- Apache-2.0 (лицензия опубликованного кода, проверено 23.10.2026)
- Автор
- MongoDB (mongodb-js)
Что получает доступ
- --readOnly или MDB_MCP_READ_ONLY=true исключает инструменты типов create/update/delete. По умолчанию readOnly=false.
- Дополнительно ограничивайте пользователя базы; права Atlas API и права чтения коллекций задаются отдельно.
Какие секреты нужны
- MDB_MCP_CONNECTION_STRING для данных; MDB_MCP_API_CLIENT_ID и MDB_MCP_API_CLIENT_SECRET для Atlas API.
Ограничения
- CLI нельзя публиковать как общий сервер без собственной аутентификации и изоляции пользователей.
- Экспорт и журналы могут содержать чувствительные данные; перед экспортом отдельно проверьте его доступность при readOnly.
- Установка, авторизация и реальные MCP-вызовы не проверены. Проверены только первоисточники и лицензия.