MongoDB MCP Server — Casos de uso, Instalar & Demo en vivo

Name: MongoDB MCP Server MCP Server
Author: kiliczsh

Por qué usarlo

Características clave

Pasa la cadena de conexión como argumento CLI — sin configuración de env-file
El modo solo lectura deshabilita todas las operaciones de mutación
Inferencia de schema a partir de documentos muestreados
Soporte para pipelines de agregación
Inspección de índices para conversaciones de optimización de consultas

Demo en vivo

Cómo se ve en la práctica

mongo-mcp-kiliczsh.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mongo-mcp-kiliczsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mongo-mcp-kiliczsh",
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://localhost:27017/mydb"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "mongo-mcp-kiliczsh": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-mongo-server",
          "mongodb://localhost:27017/mydb"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add mongo-mcp-kiliczsh -- npx -y mcp-mongo-server mongodb://localhost:27017/mydb

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: MongoDB MCP Server

Explorar una base de datos MongoDB desconocida sin escribir nada

👤 Devs incorporándose a un nuevo servicio ⏱ ~15 min beginner

Cuándo usarlo: Heredaste una instancia de Mongo y el schema no está documentado.

Requisitos previos

Usuario de Mongo de solo lectura — db.createUser({user:'reader', roles:[{role:'read', db:'mydb'}]})

Flujo

Conectar en modo solo lectura

Usa el MCP de mongo. Lista todas las colecciones e infiere el schema de las 3 más grandes por tamaño.✓ Copiado

→ Lista de colecciones + JSON schema por colección
Verificar muestras

Muéstrame 5 documentos de ejemplo de orders — anonimiza los emails.✓ Copiado

→ 5 documentos con PII redactada
Mapear relaciones

¿Qué colecciones se referencian entre sí por ObjectId? Dibuja un diagrama de texto rápido.✓ Copiado

→ Diagrama ER en texto plano

Resultado: Modelo mental de la base de datos en 10 minutos, sin necesitar un DBA.

Errores comunes

El muestreo omite campos de alta cardinalidad — Aumenta el tamaño de muestra en la llamada de inferencia; muestrea por fecha si los datos están sesgados temporalmente

Combinar con: filesystem

Optimizar una agregación lenta con asesoramiento de índices de Claude

👤 Devs de backend ⏱ ~25 min intermediate

Cuándo usarlo: Un pipeline de agregación tarda 30 segundos y no sabes qué etapa es el cuello de botella.

Flujo

Perfilar

Ejecuta esta agregación con explain=true. Muestra el plan ganador.✓ Copiado

→ Salida de explain con documentos escaneados por etapa
Diagnosticar

¿Qué etapa es el cuello de botella? ¿Qué índice ayudaría?✓ Copiado

→ Sugerencia de índice concreta con justificación
Verificar

Vuelve a hacer el explain tras añadir el índice. ¿Bajó totalDocsExamined?✓ Copiado

→ Sí/no con cifras

Resultado: Agregación 10x más rápida con un índice bien dirigido.

Errores comunes

Claude sugiere un índice que penaliza las escrituras — Pregunta: '¿Qué penalización de escritura añade este índice?' antes de aplicarlo

Encontrar documentos que violan un schema implícito

👤 Ingenieros de datos ⏱ ~20 min intermediate

Cuándo usarlo: Las bases de datos sin schema acumulan desviaciones; necesitas encontrar los infractores.

Flujo

Muestrear

Muestrea 1000 documentos de users. ¿Qué campos faltan o tienen tipos inesperados?✓ Copiado

→ Tabla de nulidad / frecuencia de tipos por campo
Encontrar

Encuentra todos los usuarios donde email es null o no es un string.✓ Copiado

→ Conteo + _ids de muestra

Resultado: Informe concreto de datos sucios que puedes pasar a scripts de migración.

Errores comunes

Las colecciones grandes provocan timeouts — Usa $sample y luego acota los seguimientos por rangos

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

mongo-mcp-kiliczsh + filesystem

Exportar resultados de agregación a JSON para herramientas downstream

Ejecuta la agregación y guarda los resultados en /tmp/orders-by-month.json.✓ Copiado

mongo-mcp-kiliczsh + github

Abrir un PR con un script de migración tras detectar desviaciones

Encontramos 1200 usuarios sin email. Abre un PR con una migración de backfill.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
find	collection, filter, projection?, limit?	Buscar documentos específicos	1 query
aggregate	collection, pipeline[], explain?	Agrupar/transformar datos	1 query
list_collections	(ninguno)	Descubrir qué hay en la BD	free
schema	collection, sample_size?	Inferir la forma a partir de documentos muestreados	1 sample read
list_indexes	collection	Conversaciones de optimización	free
insert_one	collection, document	Solo cuando no esté en modo --read-only	1 write

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Limitado por las RU/IOPS de tu cluster de Mongo
Tokens por llamada: 200–5000 dependiendo del tamaño del resultado
Monetario: Gratis (open source)
Consejo: Proyecta solo los campos que necesitas; limita el limit desde el principio

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: read on the target db

Almacenamiento de credenciales: URI pasado como argumento CLI — mantenlo fuera del historial del shell

Salida de datos: Solo hacia tu host de Mongo

No conceder nunca: dbAdmin root

Los URIs con contraseñas acaban en los argumentos del proceso; algunos sistemas los registran

Resolución de problemas

Errores comunes y soluciones

MongoServerSelectionError

Verifica conectividad, lista de IPs permitidas, configuración TLS

Verificar: mongosh con el mismo URI

Autenticación fallida

Revisa authSource en el URI (normalmente admin); confirma que el usuario existe en esa BD

Herramienta no encontrada en modo solo lectura

Elimina --read-only si necesitas escrituras; de lo contrario usa otro MCP para las escrituras

Alternativas

MongoDB MCP Server vs otros

Alternativa	Cuándo usarla	Contrapartida
MongoDB Compass	Exploración con GUI, sin IA involucrada	Sin integración con agentes; consultas manuales
mongosh en un MCP de shell	Quieres el poder completo de mongosh	Más peligroso; este MCP ofrece herramientas acotadas

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills