🗄️ Serveur Mongodb Mcp Pour Llms

Qu'est-ce que mongo-mcp ?

mongo-mcp est une implémentation de serveur MongoDB conçue pour le Protocole de Contexte de Modèle (MCP). Ce projet vise à fournir un moyen robuste et efficace de gérer et d'interagir avec des bases de données MongoDB, facilitant l'intégration transparente avec des applications utilisant le cadre MCP. En tirant parti des capacités de MongoDB, mongo-mcp permet aux développeurs de créer des applications évolutives et performantes.

Caractéristiques de mongo-mcp

• Compatibilité MCP : mongo-mcp est spécifiquement conçu pour fonctionner avec le Protocole de Contexte de Modèle, garantissant qu'il répond aux exigences des applications construites sur ce protocole.
• Scalabilité : Basé sur MongoDB, mongo-mcp peut gérer de grands volumes de données et de nombreuses connexions simultanées, le rendant adapté aux applications de niveau entreprise.
• Facilité d'utilisation : Le serveur est conçu en tenant compte de la convivialité, offrant un processus de configuration et d'installation simple.
• Open Source : Étant un dépôt public, mongo-mcp est ouvert aux contributions, permettant aux développeurs de collaborer et d'améliorer le projet.
• Communauté active : Le projet a attiré l'attention et les contributions d'une communauté croissante de développeurs, garantissant une amélioration continue et un soutien.

Comment utiliser mongo-mcp

1. Installation : Commencez par cloner le dépôt depuis GitHub :

   git clone https://github.com/QuantGeekDev/mongo-mcp.git
   

2. Configuration : Naviguez vers le répertoire du projet et configurez les paramètres du serveur selon vos besoins. Cela peut inclure la configuration des connexions à la base de données et la définition des protocoles.
3. Exécution du serveur : Utilisez les scripts ou commandes fournis pour démarrer le serveur mongo-mcp. Assurez-vous que MongoDB est installé et en cours d'exécution sur votre machine.
4. Intégration : Connectez vos applications au serveur mongo-mcp en utilisant le cadre MCP, permettant une gestion et une récupération efficaces des données.

Questions Fréquemment Posées

Qu'est-ce que le Protocole de Contexte de Modèle (MCP) ?

Le Protocole de Contexte de Modèle (MCP) est un cadre qui définit comment les applications peuvent interagir avec des modèles de données de manière structurée. Il fournit des directives pour la manipulation des données, garantissant la cohérence et la fiabilité à travers différentes applications.

mongo-mcp est-il adapté à une utilisation en production ?

Oui, mongo-mcp est conçu pour être robuste et évolutif, ce qui le rend adapté aux environnements de production. Cependant, il est recommandé de tester soigneusement le serveur dans votre cas d'utilisation spécifique avant de le déployer en environnement réel.

Comment puis-je contribuer au projet mongo-mcp ?

Les contributions sont les bienvenues ! Vous pouvez contribuer en signalant des problèmes, en soumettant des demandes de tirage ou en améliorant la documentation. Veuillez consulter la page GitHub du projet pour les directives de contribution.

Où puis-je trouver plus d'informations sur mongo-mcp ?

Pour des informations plus détaillées, de la documentation et des mises à jour, visitez le dépôt GitHub de mongo-mcp.

🗄️ MongoDB MCP Server for LLMS

A Model Context Protocol (MCP) server that enables LLMs to interact directly with MongoDB databases. Query collections, inspect schemas, and manage data seamlessly through natural language.

✨ Features

• 🔍 Collection schema inspection
• 📊 Document querying and filtering
• 📈 Index management
• 📝 Document operations (insert, update, delete)

Demo Video

https://github.com/user-attachments/assets/2389bf23-a10d-49f9-bca9-2b39a1ebe654

🚀 Quick Start

To get started, find your mongodb connection url and add this configuration to your Claude Desktop config file:

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

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "mongo-mcp",
        "mongodb://<username>:<password>@<host>:<port>/<database>?authSource=admin"
      ]
    }
  }
}

Installing via Smithery

To install MongoDB MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mongo-mcp --client claude

Prerequisites

• Node.js 18+
• npx
• Docker and Docker Compose (for local sandbox testing only)
• MCP Client (Claude Desktop App for example)

Test Sandbox Setup

If you don't have a mongo db server to connect to and want to create a sample sandbox, follow these steps

1. Start MongoDB using Docker Compose:

docker-compose up -d

2. Seed the database with test data:

npm run seed

Configure Claude Desktop

Add this configuration to your Claude Desktop config file:

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

Local Development Mode:

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": [
        "dist/index.js",
        "mongodb://root:example@localhost:27017/test?authSource=admin"
      ]
    }
  }
}

Test Sandbox Data Structure

The seed script creates three collections with sample data:

Users

• Personal info (name, email, age)
• Nested address with coordinates
• Arrays of interests
• Membership dates

Products

• Product details (name, SKU, category)
• Nested specifications
• Price and inventory info
• Tags and ratings

Orders

• Order details with items
• User references
• Shipping and payment info
• Status tracking

🎯 Example Prompts

Try these prompts with Claude to explore the functionality:

Basic Operations

"What collections are available in the database?"
"Show me the schema for the users collection"
"Find all users in San Francisco"

Advanced Queries

"Find all electronics products that are in stock and cost less than $1000"
"Show me all orders from the user john@example.com"
"List the products with ratings above 4.5"

Index Management

"What indexes exist on the users collection?"
"Create an index on the products collection for the 'category' field"
"List all indexes across all collections"

Document Operations

"Insert a new product with name 'Gaming Laptop' in the products collection"
"Update the status of order with ID X to 'shipped'"
"Find and delete all products that are out of stock"

📝 Available Tools

The server provides these tools for database interaction:

Query Tools

• find: Query documents with filtering and projection
• listCollections: List available collections
• insertOne: Insert a single document
• updateOne: Update a single document
• deleteOne: Delete a single document

Index Tools

• createIndex: Create a new index
• dropIndex: Remove an index
• indexes: List indexes for a collection

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.