🗄️ Servidor Mongodb Mcp Para Llms

¿Qué es mongo-mcp?

mongo-mcp es una implementación de servidor MongoDB diseñada para el Protocolo de Contexto de Modelo (MCP). Este proyecto tiene como objetivo proporcionar una forma robusta y eficiente de gestionar e interactuar con bases de datos MongoDB, facilitando la integración sin problemas con aplicaciones que utilizan el marco MCP. Al aprovechar las capacidades de MongoDB, mongo-mcp permite a los desarrolladores construir aplicaciones escalables y de alto rendimiento.

Características de mongo-mcp

• Compatibilidad con MCP: mongo-mcp está diseñado específicamente para trabajar con el Protocolo de Contexto de Modelo, asegurando que cumpla con los requisitos de las aplicaciones construidas sobre este protocolo.
• Escalabilidad: Basado en MongoDB, mongo-mcp puede manejar grandes volúmenes de datos y numerosas conexiones concurrentes, lo que lo hace adecuado para aplicaciones a nivel empresarial.
• Facilidad de uso: El servidor está diseñado pensando en la facilidad de uso, proporcionando un proceso de configuración y configuración sencillo.
• Código abierto: Al ser un repositorio público, mongo-mcp está abierto a contribuciones, permitiendo a los desarrolladores colaborar y mejorar el proyecto.
• Comunidad activa: El proyecto ha atraído la atención y contribuciones de una comunidad creciente de desarrolladores, asegurando una mejora y soporte continuos.

Cómo usar mongo-mcp

1. Instalación: Comienza clonando el repositorio desde GitHub:

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

2. Configuración: Navega al directorio del proyecto y configura los ajustes del servidor de acuerdo a tus requisitos. Esto puede incluir la configuración de conexiones a la base de datos y la definición de protocolos.
3. Ejecutar el servidor: Utiliza los scripts o comandos proporcionados para iniciar el servidor mongo-mcp. Asegúrate de que MongoDB esté instalado y en funcionamiento en tu máquina.
4. Integración: Conecta tus aplicaciones al servidor mongo-mcp utilizando el marco MCP, lo que permite una gestión y recuperación de datos eficientes.

Preguntas Frecuentes

¿Qué es el Protocolo de Contexto de Modelo (MCP)?

El Protocolo de Contexto de Modelo (MCP) es un marco que define cómo las aplicaciones pueden interactuar con modelos de datos de manera estructurada. Proporciona pautas para la manipulación de datos, asegurando consistencia y fiabilidad en diferentes aplicaciones.

¿Es mongo-mcp adecuado para uso en producción?

Sí, mongo-mcp está diseñado para ser robusto y escalable, lo que lo hace adecuado para entornos de producción. Sin embargo, se recomienda probar exhaustivamente el servidor en tu caso de uso específico antes de implementarlo en un entorno en vivo.

¿Cómo puedo contribuir al proyecto mongo-mcp?

¡Las contribuciones son bienvenidas! Puedes contribuir reportando problemas, enviando solicitudes de extracción o mejorando la documentación. Por favor, consulta la página de GitHub del proyecto para obtener pautas de contribución.

¿Dónde puedo encontrar más información sobre mongo-mcp?

Para obtener información más detallada, documentación y actualizaciones, visita el repositorio de 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.