MongoDB MCP Server

Что умеет сервер

Это официальный MCP-сервер MongoDB, он написан на Node.js и запускается командой npx -y mongodb-mcp-server. Он работает и с обычными базами MongoDB, и с облачным сервисом MongoDB Atlas. Инструменты для данных покрывают типичную работу: find, aggregate, count, вставка, обновление и удаление документов, создание и удаление коллекций и индексов, схема и размер коллекции, план запроса explain, статистика базы, журнал mongod и экспорт результатов в формате EJSON.

Если задать учётные данные сервисного аккаунта Atlas, появляются инструменты Atlas: список организаций, проектов и кластеров, создание проекта, бесплатного и платного кластера, пользователей базы и списков доступа, подсказки Performance Advisor, загрузка тестовых наборов данных и управление потоковой обработкой. Отдельно есть инструменты работы с локальными развёртываниями Atlas Local и инструменты ассистента MongoDB для поиска по официальной документации.

Когда использовать

Подключайте сервер, когда агенту нужно изучить незнакомую коллекцию, составить агрегацию, проверить индексы или разобраться, почему запрос медленный, прямо из чата. Режим Atlas удобен тем, кто хочет поднять тестовый кластер, подключиться к нему и загрузить пример данных одной просьбой агенту.

Для работы с Atlas MongoDB рекомендует использовать плагин mongodb-atlas, который подключает облачный сервер Atlas по OAuth и не требует локального запуска. Такие плагины есть для Cursor, VS Code, Claude, Codex, GitHub Copilot CLI и Grok. Локальный сервер из этой записи нужен для самостоятельно развёрнутых баз и для случаев, когда нужен полный контроль над запуском.

Ограничения и безопасность

Все примеры конфигурации в README включают флаг --readOnly, который оставляет только чтение, подключение и метаданные. Уберите его, только если агенту действительно нужно менять данные. Для опасных инструментов по умолчанию включено подтверждение: drop-database, drop-collection, delete-many, drop-index, а также часть инструментов Atlas просят согласие, но только если клиент поддерживает запрос подтверждения (elicitation).

Серверные скрипты JavaScript в запросах ($where, $function, $accumulator) по умолчанию отключены. Данные из базы сервер оборачивает в предупреждение о возможной инъекции инструкций. За один вызов find или aggregate по умолчанию возвращается не больше 100 документов. Строку подключения и ключи Atlas авторы просят передавать через переменные окружения, а не аргументы командной строки, так как аргументы видны в списке процессов. Сбор телеметрии включён по умолчанию, отключить его можно параметром MDB_MCP_TELEMETRY=disabled. Нужен Node.js не ниже 22.13, поддержка Node 20 объявлена устаревшей.

Мастер настройки

Интерактивная настройка (строка подключения или ключи Atlas):

npx -y mongodb-mcp-server@latest setup

Строка подключения

Добавьте в конфигурацию клиента, подставив свою строку подключения. Строка может указывать на любую базу MongoDB, локальную или кластер Atlas. Синтаксис файла конфигурации в разных клиентах отличается, ниже приведён общий вид.

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/myDatabase"
      }
    }
  }
}

Ключи Atlas

Для инструментов Atlas нужны данные сервисного аккаунта Atlas API:

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_API_CLIENT_ID": "your-atlas-service-accounts-client-id",
        "MDB_MCP_API_CLIENT_SECRET": "your-atlas-service-accounts-client-secret"
      }
    }
  }
}

Docker

С параметрами подключения через переменные окружения:

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MDB_MCP_CONNECTION_STRING",
        "-e",
        "MDB_MCP_READ_ONLY=true",
        "mongodb/mongodb-mcp-server:latest"
      ],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
      }
    }
  }
}

Плагины и навык настройки

Плагин для облачного Atlas (OAuth, ничего не запускается локально) в GitHub Copilot CLI:

copilot plugin install mongodb-atlas

Плагин с локальным сервером:

copilot plugin install mongodb

Навык, с помощью которого агент сам настраивает локальный сервер:

npx skills add https://github.com/mongodb/agent-skills --skill mongodb-mcp-setup