mongodb-mcp-server

mongodb-mcp-server

mongodb-jsApache-2.0
1k звёзд255 форков
MongoDB MCP-сервер — официальное решение от команды MongoDB для интеграции с AI-ассистентами через протокол MCP. Сервер превращает базу данных MongoDB в источник данных, к которому можно обращаться на естественном языке. Разработчики и администраторы могут через AI-бота выполнять запросы, просматривать структуру баз, запускать агрегации и получать статистику — без ручного написания кода. Сервер работает в режиме read-only по умолчанию, что делает его безопасным для продакшен-баз. Подключается по обычной строке соединения MongoDB и не требует дополнительных библиотек.
Ai-mlMongodb
Открыть на GitHub

Установка

npx -y mongodb-mcp-server

Характеристики

Общее

  • СтатусСообщество
  • Разработчикmongodb-js
  • ЛицензияApache-2.0

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Подключение к любому экземпляру MongoDB — локальному, облачному (Atlas) или Docker-контейнеру.
  • Выполнение запросов find с фильтрацией, проекцией, сортировкой и лимитом.
  • Запуск агрегационных пайплайнов с любым количеством стадий.
  • Получение списка баз данных и коллекций в одной команде.
  • Просмотр статистики коллекции (размер, количество документов, индексы).
  • Выполнение команд администратора через runCommand.
  • Создание и удаление индексов (если режим не только чтение).
  • Работа с временными коллекциями и транзакциями (при соответствующей настройке).
  • Поддержка MongoDB Shell формата JSON для запросов.

Как подключить

  1. Установите сервер через npx (Node.js должен быть установлен): npx -y mongodb-mcp-server
  2. Настройте переменную окружения со строкой подключения: export MDB_MCP_CONNECTION_STRING="mongodb+srv://user:pass@cluster.mongodb.net"
  3. Добавьте конфигурацию в MCP-клиент. Пример для Claude Desktop (файл конфигурации): { "mcpServers": { "mongodb": { "command": "npx", "args": ["-y", "mongodb-mcp-server", "--readOnly"], "env": { "MDB_MCP_CONNECTION_STRING": "${MDB_MCP_CONNECTION_STRING}" } } } }
  4. Перезапустите клиент, чтобы сервер подключился.

Примеры запросов

  • «Покажи все базы данных на сервере»
  • «Найди в коллекции users пять документов, где поле age больше 30, и верни только имя и email»
  • «Выполни агрегацию: сгруппируй заказы по статусу и посчитай количество в каждой группе»
  • «Создай индекс на поле createdAt в коллекции logs для ускорения поиска»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio (стандартный ввод-вывод)
  • Лицензия: Apache-2.0
  • Совместимые клиенты: Claude Desktop, VS Code (через расширение MCP), Cursor, и любые другие MCP-совместимые приложения
  • Исходный код: github.com/mongodb-js/mongodb-mcp-server

Поделиться