Servidor MCP MongoDB para LLMS

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a los LLM interactuar directamente con las bases de datos MongoDB. Consulta colecciones, inspecciona esquemas y gestiona datos sin problemas mediante lenguaje natural.

✨ Características

• 🔍 Inspección del esquema de colección

• 📊 Consulta y filtrado de documentos

• 📈 Gestión de índices

• 📝 Operaciones con documentos (insertar, actualizar, eliminar)

Related MCP server: MongoDB MCP Server for LLMs

Vídeo de demostración

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

🚀 Inicio rápido

Para comenzar, busque la URL de conexión de mongodb y agregue esta configuración a su archivo de configuración de Claude Desktop:

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

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

Instalación mediante herrería

Para instalar MongoDB MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Prerrequisitos

• Node.js 18+

• npx

• Docker y Docker Compose (solo para pruebas en entornos locales)

• Cliente MCP (aplicación de escritorio Claude, por ejemplo)

Configuración de la zona de pruebas

Si no tiene un servidor Mongo DB al cual conectarse y desea crear un entorno de pruebas de muestra, siga estos pasos

1. Inicie MongoDB usando Docker Compose:

docker-compose up -d

2. Sembrar la base de datos con datos de prueba:

npm run seed

Configurar Claude Desktop

Agregue esta configuración a su archivo de configuración de Claude Desktop:

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

Modo de desarrollo local:

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

Estructura de datos de la zona de pruebas

El script de semilla crea tres colecciones con datos de muestra:

Usuarios

• Información personal (nombre, correo electrónico, edad)

• Dirección anidada con coordenadas

• Matrices de intereses

• Fechas de membresía

Productos

• Detalles del producto (nombre, SKU, categoría)

• Especificaciones anidadas

• Información de precios e inventario

• Etiquetas y valoraciones

Pedidos

• Detalles del pedido con artículos

• Referencias de usuario

• Información de envío y pago

• Seguimiento del estado

🎯 Ejemplos de indicaciones

Pruebe estas indicaciones con Claude para explorar la funcionalidad:

Operaciones básicas

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

Consultas avanzadas

"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"

Gestión de índices

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

Operaciones de documentos

"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"

📝 Herramientas disponibles

El servidor proporciona estas herramientas para la interacción con la base de datos:

Herramientas de consulta

• find : Consultar documentos con filtrado y proyección

• listCollections : Lista de colecciones disponibles

• insertOne : Insertar un solo documento

• updateOne : Actualizar un solo documento

• deleteOne : Eliminar un solo documento

Herramientas de índice

• createIndex : Crea un nuevo índice

• dropIndex : Eliminar un índice

• indexes : enumera los índices de una colección

📜 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.