Installer et Configurer MongoDB MCP Serveur

Dans le paysage en constante évolution du développement logiciel, l'intégration de l'Intelligence Artificielle n'est plus un concept futuriste mais une réalité actuelle. Les outils basés sur l'IA deviennent rapidement indispensables pour les développeurs, rationalisant les flux de travail et améliorant la productivité. Reconnaissant cette tendance, MongoDB a introduit un outil révolutionnaire qui comble le fossé entre votre base de données et l'IA : le serveur MongoDB Model Context Protocol (MCP). Ce tutoriel fournit un guide complet, étape par étape, pour installer et configurer le serveur MongoDB MCP, vous permettant de tirer pleinement parti du potentiel de l'IA dans votre environnement de développement.

💡

Vous voulez un excellent outil de test d'API qui génère une magnifique documentation d'API ?

Vous voulez une plateforme intégrée, tout-en-un pour que votre équipe de développeurs travaille avec une productivité maximale ?

Apidog répond à toutes vos exigences, et remplace Postman à un prix beaucoup plus abordable !

button

Qu'est-ce que le serveur MongoDB MCP ?

Le serveur MongoDB MCP est un nouvel outil puissant conçu pour connecter vos déploiements MongoDB à une variété de clients basés sur l'IA qui prennent en charge le Model Context Protocol (MCP). Que vous utilisiez MongoDB Atlas, la base de données cloud entièrement gérée, ou une édition Community ou Enterprise Advanced auto-hébergée, le serveur MCP permet une interaction transparente avec vos données en utilisant le langage naturel. Cela signifie que vous pouvez effectuer une large gamme d'opérations de base de données, des requêtes de données simples aux tâches administratives complexes, le tout via des commandes intuitives et conversationnelles au sein de vos outils de développement IA préférés.

Capture d'écran de l'interface utilisateur de MongoDB Atlas montrant des options liées à l'IA et au MCP.

Le MCP est un standard ouvert, initialement introduit par Anthropic, qui gagne rapidement du terrain pour sa capacité à créer une couche de communication standardisée entre les agents IA et divers systèmes de données. En implémentant ce protocole, MongoDB s'assure que ses utilisateurs peuvent rester à la pointe du développement axé sur l'IA. Le serveur MCP facilite un canal de communication bidirectionnel, vous permettant non seulement d'interroger vos données, mais aussi de fournir à vos grands modèles linguistiques (LLM) les informations les plus récentes et contextuellement pertinentes de votre base de données. C'est un atout majeur pour des tâches telles que l'exploration de données, l'administration de bases de données et la génération de code sensible au contexte.

Le serveur MongoDB MCP prend en charge un écosystème croissant de clients MCP, notamment :

Windsurf : Un éditeur de code natif IA où le serveur MCP est disponible prêt à l'emploi.
Cursor : Un éditeur de code populaire basé sur l'IA.
GitHub Copilot dans Visual Studio Code : Apportant la puissance de votre base de données à l'IDE le plus populaire au monde.
Claude d'Anthropic : Interagissez avec votre base de données directement depuis l'application de bureau Claude.

Commençons !

Capture d'écran du dépôt GitHub du serveur MongoDB MCP

Prérequis

Avant de nous plonger dans le processus d'installation, vous devez avoir quelques prérequis en place :

Node.js et npx : Le serveur MongoDB MCP est une application Node.js et est généralement installé et exécuté à l'aide de npx, le lanceur de paquets Node.js. Vous aurez besoin de Node.js version 18 ou supérieure installé sur votre système. Vous pouvez vérifier votre version de Node.js en ouvrant un terminal ou une invite de commande et en exécutant node -v.
Chaîne de connexion MongoDB ou identifiants d'API Atlas : Pour se connecter à votre base de données, le serveur MCP a besoin soit d'une chaîne de connexion MongoDB standard, soit d'identifiants d'API pour votre compte MongoDB Atlas.
Chaîne de connexion : Il s'agit du format URI standard pour se connecter à une instance MongoDB. Il inclut le nom d'utilisateur, le mot de passe, l'hôte, le port et le nom de la base de données.
Identifiants d'API Atlas : Si vous utilisez MongoDB Atlas, vous pouvez créer un compte de service avec les permissions nécessaires et utiliser l'ID client API et le Secret client générés pour l'authentification. Cette méthode est requise pour utiliser les outils spécifiques à Atlas.
Un client MCP : Vous aurez besoin d'installer l'un des clients MCP pris en charge, tels que Cursor, Claude Desktop ou Visual Studio Code avec l'extension GitHub Copilot.
Docker (Facultatif) : Si vous préférez exécuter le serveur MCP dans un environnement conteneurisé, vous aurez besoin d'installer Docker et Docker Compose. C'est particulièrement utile pour les tests en bac à sable locaux et pour éviter une installation locale de Node.js.

Installation et Configuration

Le processus d'installation et de configuration du serveur MongoDB MCP varie légèrement en fonction du client MCP que vous utilisez. Le cœur du processus implique l'ajout d'une configuration JSON au fichier de paramètres de votre client qui lui indique comment lancer et communiquer avec le serveur MCP.

La commande principale pour exécuter le serveur est npx -y mongodb-mcp-server. Le drapeau -y confirme automatiquement l'installation du paquet s'il n'est pas déjà présent.

Configuration dans Cursor

Cursor est un éditeur de code axé sur l'IA qui gagne rapidement en popularité. Voici comment vous pouvez configurer le serveur MongoDB MCP dans Cursor :

Ouvrez les paramètres de Cursor : Lancez Cursor et cliquez sur l'icône en forme de roue dentée dans le coin supérieur droit de la fenêtre pour ouvrir les paramètres.
Naviguez vers la section MCP : Dans le panneau des paramètres à gauche, cliquez sur "MCP".
Ajoutez un nouveau serveur MCP global : Cliquez sur le bouton "Add new global MCP server". Cela ouvrira un fichier de configuration JSON.
Entrez la configuration : Copiez et collez la configuration JSON suivante dans le fichier. Vous devrez la personnaliser avec vos détails de connexion.

JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "environments": [
      {
        "name": "ATLAS_API_CLIENT_ID",
        "value": "your-atlas-api-client-id"
      },
      {
        "name": "ATLAS_API_CLIENT_SECRET",
        "value": "your-atlas-api-client-secret"
      }
    ]
  }
}

Si vous utilisez une chaîne de connexion au lieu d'identifiants d'API Atlas, votre configuration ressemblera à ceci :JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

Enregistrez la configuration : Enregistrez le fichier. Cursor pourra désormais utiliser votre nouveau serveur MongoDB MCP.

Une fois le serveur configuré, vous pouvez désormais interagir avec votre base de données en utilisant le langage naturel dans Cursor. Si vous avez utilisé vos identifiants d'API Atlas, vous aurez accès à un riche ensemble d'outils spécifiques à Atlas, vous permettant de créer des clusters gratuits, de gérer des listes d'accès, de créer des utilisateurs de base de données, et bien plus encore. Si vous avez utilisé une chaîne de connexion, vous aurez accès à des outils de gestion de base de données, tels que la liste des bases de données et des collections, la gestion des index et l'exécution d'opérations CRUD (Create, Read, Update, Delete).

Configuration dans Claude Desktop

Si vous êtes un utilisateur de Claude d'Anthropic, vous pouvez intégrer le serveur MongoDB MCP directement dans l'application de bureau Claude.

Ouvrez le fichier de configuration : Démarrez l'application de bureau Claude, puis naviguez vers Settings > Developer > Edit Config. Cela ouvrira le fichier claude_desktop_config.json dans votre éditeur de texte par défaut. L'emplacement de ce fichier est généralement :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%/Claude/claude_desktop_config.json

Ajoutez la configuration du serveur MCP : Ajoutez la configuration suivante à l'objet mcpServers dans le fichier JSON.

JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/test"
      ]
    }
  }
}

Assurez-vous de remplacer la chaîne de connexion d'espace réservé par votre chaîne de connexion réelle.

Redémarrez Claude Desktop : Fermez et redémarrez l'application de bureau Claude.
Vérifiez le serveur : Cliquez sur l'icône en forme de marteau dans Claude Desktop. Le serveur MongoDB MCP devrait maintenant être répertorié comme un outil disponible.

Configuration dans Visual Studio Code avec GitHub Copilot

Pour les millions de développeurs qui utilisent Visual Studio Code, le serveur MongoDB MCP peut être intégré à GitHub Copilot pour apporter l'interaction en langage naturel avec la base de données à votre IDE préféré.

Ouvrez la palette de commandes : Ouvrez VS Code et appuyez sur Ctrl+Shift+P (ou Cmd+Shift+P sur macOS) pour ouvrir la palette de commandes.
Ajoutez un nouveau serveur MCP : Tapez "mcp" dans la palette de commandes et sélectionnez "MCP: Add Servers".
Choisissez Command Standard I/O : Sélectionnez "Command Standard I/O" comme type de serveur.
Entrez la commande : Entrez la commande npx -y mongodb-mcp-server et donnez un nom à votre serveur, par exemple, "mongodb".
Configurez dans settings.json : Cela ouvrira votre fichier settings.json. Ici, vous pouvez ajouter vos arguments et variables d'environnement. Par exemple, pour utiliser une chaîne de connexion :

JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

Ou, pour utiliser les identifiants d'API Atlas :JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "options": {
      "env": {
        "ATLAS_API_CLIENT_ID": "your-atlas-api-client-id",
        "ATLAS_API_CLIENT_SECRET": "your-atlas-api-client-secret"
      }
    }
  }
}

Démarrez le serveur : Vous pouvez démarrer le serveur en cliquant sur le bouton "Start" qui apparaît au-dessus du nom du serveur dans votre fichier settings.json, ou en ouvrant la palette de commandes, en recherchant "MCP: List Servers", en sélectionnant votre serveur, puis en sélectionnant "Start Server".

Une fois le serveur en cours d'exécution, vous pouvez utiliser le mode agent de GitHub Copilot pour interagir avec votre environnement MongoDB Atlas. Vous pouvez lui demander de lister vos projets, de créer de nouveaux clusters, de gérer des utilisateurs, et bien plus encore, le tout depuis VS Code.

Configuration Avancée

Le serveur MongoDB MCP offre plusieurs options de configuration avancées pour adapter son comportement à vos besoins spécifiques.

Mode Lecture Seule

Pour une sécurité accrue, notamment lors de la connexion à des bases de données de production, vous pouvez exécuter le serveur en mode lecture seule. Cela empêchera toute opération d'écriture, telle que la création, la mise à jour ou la suppression de documents. Vous pouvez activer le mode lecture seule à l'aide d'un argument de ligne de commande :

npx mongodb-mcp-server --readOnly

Ou en définissant une variable d'environnement :

export MDB_MCP_READ_ONLY=true

Désactivation d'outils spécifiques

Vous pouvez désactiver des outils spécifiques pour restreindre les capacités du serveur. C'est utile pour la sécurité ou pour simplifier les commandes disponibles. Vous pouvez désactiver des outils à l'aide de l'argument de ligne de commande --disabledTools, suivi d'une liste de noms d'outils séparés par des espaces.

npx mongodb-mcp-server --disabledTools create update delete atlas collectionSchema

Alternativement, vous pouvez utiliser la variable d'environnement MDB_MCP_DISABLED_TOOLS avec une liste de noms d'outils séparés par des virgules.

export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema"

Télémétrie

Par défaut, le serveur MongoDB MCP collecte des données d'utilisation anonymes pour aider à améliorer le produit. Si vous souhaitez désactiver cela, vous pouvez utiliser l'argument de ligne de commande --telemetry disabled ou la variable d'environnement MDB_MCP_TELEMETRY=disabled.

Installation Docker

Pour ceux qui préfèrent un environnement conteneurisé, le serveur MongoDB MCP peut être exécuté dans un conteneur Docker. Cela offre une isolation et élimine le besoin d'une installation locale de Node.js.

Pour exécuter le serveur avec une chaîne de connexion :

docker run --rm -i -e MDB_MCP_CONNECTION_STRING="your-mongodb-connection-string" mongodb/mongodb-mcp-server:latest

Pour exécuter avec les identifiants d'API Atlas :

docker run --rm -i -e MDB_MCP_API_CLIENT_ID="your-atlas-api-client-id" -e MDB_MCP_API_CLIENT_SECRET="your-atlas-api-client-secret" mongodb/mongodb-mcp-server:latest

Vous devrez ensuite configurer votre client MCP pour utiliser la commande docker au lieu de npx. Par exemple, dans Claude Desktop :JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MDB_MCP_API_CLIENT_ID=your-atlas-api-client-id",
        "-e",
        "MDB_MCP_API_CLIENT_SECRET=your-atlas-api-client-secret",
        "mongodb/mongodb-mcp-server:latest"
      ]
    }
  }
}

Conclusion

Le serveur MongoDB MCP représente un pas en avant significatif dans l'intégration de l'IA et des bases de données. En fournissant un moyen standardisé pour les clients IA d'interagir avec MongoDB, il ouvre un monde de possibilités pour les développeurs. De l'interrogation en langage naturel et l'exploration de données à l'administration de base de données assistée par l'IA et la génération de code, le serveur MCP est appelé à devenir un outil essentiel dans la boîte à outils du développeur moderne.

Ce tutoriel a fourni un guide complet pour démarrer avec le serveur MongoDB MCP. En suivant ces étapes, vous pouvez rapidement et facilement connecter vos déploiements MongoDB à vos outils IA préférés et commencer à récolter les bénéfices du développement basé sur l'IA. Comme il s'agit d'une technologie nouvelle et en évolution, assurez-vous de consulter la documentation officielle de MongoDB et le dépôt GitHub pour les dernières mises à jour et fonctionnalités. L'avenir de l'interaction avec les bases de données est là, et avec le serveur MongoDB MCP, vous êtes à la pointe.

💡

button