MongoDB MCP Server
Официальный MCP-сервер MongoDB: запросы и агрегации к базам, управление индексами, кластерами Atlas и локальными развертываниями
Установка
npx -y mongodb-mcp-server@latest setupИнтерактивная настройка строки подключения или учетных данных Atlas.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к любой базе MongoDB по строке подключения: поиск, агрегации, подсчет, схема и индексы коллекций, план выполнения запроса, экспорт результатов, а также вставка, обновление и удаление документов. С учетными данными сервисного аккаунта Atlas добавляются инструменты для проектов, кластеров, пользователей баз, списков доступа, алертов, советника по производительности и Stream Processing. Есть инструменты для локальных развертываний Atlas Local и поиск по базе знаний MongoDB. Флаг --readOnly оставляет только операции чтения.
Для кого. Для разработчиков и администраторов, которые работают с MongoDB или MongoDB Atlas.
Подходит, если
- Нужно изучить схему коллекций и написать агрегацию по реальным данным
- Нужно понять, почему запрос медленный, и подобрать индекс
- Нужно создать или осмотреть кластер Atlas из агента
Не подходит, если
- Проект на реляционной базе
- Агенту нельзя давать доступ к производственным данным даже на чтение
Пример запроса к агенту
Покажи схему коллекции orders и найди, каких индексов не хватает для частых запросовОграничения
Нужен Node.js 22.13 или новее. Инструменты Atlas работают только с учетными данными сервисного аккаунта, права стоит выдавать минимальные. Без --readOnly агент может удалять документы, коллекции и базы. Сервис Atlas из России может быть недоступен, самостоятельно развернутая MongoDB работает без ограничений.
Как отключить. Удалите блок MongoDB из конфигурации MCP-клиента или удалите плагин mongodb в агенте.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MDB_MCP_CONNECTION_STRING секрет | Строка подключения к MongoDB |
| MDB_MCP_API_CLIENT_ID секрет | Client ID сервисного аккаунта Atlas для инструментов Atlas |
| MDB_MCP_API_CLIENT_SECRET секрет | Секрет сервисного аккаунта Atlas |
| MDB_MCP_READ_ONLY | true оставляет только операции чтения |
| MDB_MCP_DISABLED_TOOLS | Список отключаемых инструментов |
Проверка безопасности
- Без --readOnly может удалять документы, коллекции и базы данных
- Может создавать и менять кластеры Atlas, что влияет на расходы
- Работает со строками подключения и секретами
Коротко о README
README предлагает несколько путей установки: официальные плагины mongodb и mongodb-atlas для разных агентов, интерактивный скрипт setup, скилл настройки и ручную конфигурацию. Все примеры конфигурации идут с --readOnly. Приведен полный список инструментов для баз, Atlas, Atlas Local и базы знаний, а также все параметры конфигурации, прокси и развертывание в облаке. Лицензия Apache-2.0.
Частые вопросы
Как запретить агенту изменять данные?
Запускайте сервер с флагом --readOnly или переменной MDB_MCP_READ_ONLY=true: инструменты создания, изменения и удаления не регистрируются.
Можно ли не запускать сервер локально?
Для Atlas есть управляемый MongoDB сервер с OAuth, он ставится плагином mongodb-atlas в Cursor, VS Code, Claude и Codex.
Похожие
166 скиллов для научных задач: биоинформатика, хемоинформатика, клинические данные, геоданные и доступ к 100+ базам
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
Официальные скиллы Hugging Face: работа с Hub через CLI hf, датасеты, обучение моделей, Spaces, оценка и деплой
Экономный по токенам MCP-сервер для PostgreSQL, MySQL, MariaDB, SQL Server и SQLite с режимом только для чтения