MongoDB

Servidor MCP de MongoDB

Un servidor de Model Context Protocol que proporciona acceso de solo lectura a bases de datos MongoDB mediante herramientas y recursos MCP estandarizados.

Descripción general

Este servidor MCP de MongoDB permite a los asistentes de IA consultar y analizar directamente bases de datos MongoDB sin acceso de escritura, manteniendo la seguridad de los datos y proporcionando potentes capacidades de exploración de datos.

Características

Operaciones de MongoDB

• Exploración de bases de datos: Listar bases de datos y colecciones
• Descubrimiento de esquemas: Inferir esquemas de colecciones a partir de documentos de muestra
• Consultas: Ejecutar consultas de MongoDB con filtrado, proyección, ordenación y limitación
• Agregación: Ejecutar canalizaciones de agregación de solo lectura con validación de seguridad
• Búsqueda de texto: Realizar búsquedas de texto completo en colecciones con índices de texto
• Consultas geoespaciales: Encontrar ubicaciones cercanas a puntos, dentro de polígonos o que intersectan geometrías
• Operaciones con documentos: Contar documentos, muestrear documentos aleatorios, buscar documentos por ID
• Análisis de datos: Obtener estadísticas de colecciones, información de índices y planes de ejecución de consultas
• Información de rendimiento: Examinar planes de ejecución de consultas para optimizar el rendimiento
• Exploración de datos: Obtener valores distintos, distribuciones de campos y muestras de datos
• Conversión de formato: Exportar resultados de consultas en formatos JSON o CSV

Capacidades mejoradas

• Inferencia de esquemas: Detectar automáticamente tipos de datos y estructura a partir de documentos
• Sugerencias de visualización: Recomendaciones inteligentes para la visualización de datos basadas en el contenido de los resultados
• Validación de seguridad: Evita operaciones de escritura en canalizaciones de agregación
• Documentación con ejemplos: Cada herramienta incluye ejemplos detallados en su descripción

Requisitos

Variables de entorno

• MONGODB_URI (obligatorio): Cadena de conexión de MongoDB con autenticación si es necesaria
• MONGODB_DEFAULT_DATABASE (opcional): Nombre de base de datos predeterminado cuando no se especifica en las consultas

Requisitos previos

• Acceso de red al servidor MongoDB
• Credenciales de autenticación si la instancia de MongoDB lo requiere
• Permisos de lectura adecuados en las bases de datos de destino

Instalación

Compilación desde el código fuente

Instalar dependencias:

npm install

Compilar el servidor:

npm run build

Para desarrollo con recompilación automática:

npm run watch

Integración con Claude Desktop

Para usar con Claude Desktop, añade la configuración del servidor:

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

{
  "mcpServers": {
    "mongodb": {
      "command": "/path/to/mongodb-server/build/index.js",
      "env": {
        "MONGODB_URI": "mongodb://username:password@hostname:port/database",
        "MONGODB_DEFAULT_DATABASE": "your_default_db"
      }
    }
  }
}

Integración con Claude Web

Para Claude Web a través de la extensión MCP de Chrome, añade la configuración a los ajustes de Cline MCP:

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": ["/path/to/mongodb-server/build/index.js"],
      "env": {
        "MONGODB_URI": "mongodb://username:password@hostname:port/database",
        "MONGODB_DEFAULT_DATABASE": "your_default_db"
      }
    }
  }
}

Integración con Claude Code

Para usar con Claude Code, utiliza los siguientes comandos:

cd /path/to/my/project
claude mcp add mongo-server /path/to/mongodb-mcp/build/index.js -e "MONGODB_URI=mongodb://user@password:27017/dbname?authSource=authDbName" -e MONGO_DEFAULT_DATABASE=dbname 

Asegúrate de reemplazar los marcadores de posición con tu cadena de conexión de MongoDB real y el nombre de base de datos predeterminado.

Si está configurado correctamente, deberías ver lo siguiente al ejecutar claude:

╭───────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code research preview!            │
│                                                       │
│   /help for help                                      │
│                                                       │
│   cwd: <path-to-project-directory>                    │
│                                                       │
│   ─────────────────────────────────────────────────── │
│                                                       │
│   MCP Servers:                                        │
│                                                       │
│   • mongo-server                            connected │
╰───────────────────────────────────────────────────────╯

Si encuentras problemas, consulta la documentación de Claude Code.

Consideraciones de seguridad

• Este servidor proporciona acceso de solo lectura por diseño
• Las cadenas de conexión pueden contener información de autenticación sensible
• Almacena las cadenas de conexión de forma segura en variables de entorno
• Utiliza un usuario de MongoDB con permisos de solo lectura

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. Utiliza el Inspector MCP, que está disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.