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)

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

Inicie MongoDB usando Docker Compose:

docker-compose up -d

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.

MongoDB MCP Server for LLMs

Integrations