Servidor MCP de MongoDB
Un servidor de protocolo de contexto de modelo que proporciona acceso de solo lectura a las bases de datos MongoDB a través de herramientas y recursos MCP estandarizados.
Descripción general
Este servidor MongoDB MCP 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 : enumerar bases de datos y colecciones
- Descubrimiento de esquemas : inferir esquemas de colección a partir de documentos de muestra
- Consultas : Ejecute consultas MongoDB con filtrado, proyección, ordenación y limitación.
- Agregación : ejecute canales de agregación de solo lectura con validación de seguridad
- Búsqueda de texto : realice una búsqueda de texto completo en colecciones con índices de texto
- Consultas geoespaciales : encuentre ubicaciones cerca de puntos, dentro de polígonos o geometrías que se intersecan
- Operaciones con documentos : contar documentos, tomar muestras aleatorias de documentos, buscar documentos por ID
- Análisis de datos : obtenga estadísticas de recopilación, información de índices y planes de ejecución de consultas
- Información sobre el rendimiento : examine los planes de ejecución de consultas para optimizar el rendimiento
- Exploración de datos : obtenga 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 : detecta automáticamente los tipos de datos y la estructura de los documentos
- Sugerencias de visualización : sugerencias inteligentes para la visualización de datos basadas en el contenido de los resultados
- Validación de seguridad : evita operaciones de escritura en canales de agregación
- Documentación rica en 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 necesarioMONGODB_DEFAULT_DATABASE (opcional): nombre de base de datos predeterminado cuando no se especifica en las consultas
Prerrequisitos
- 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
Construyendo desde la fuente
Instalar dependencias:
Construir el servidor:
Para desarrollo con reconstrucción automática:
Integración con Claude Desktop
Para utilizar con Claude Desktop, agregue 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, agregue la configuración a la configuración 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 utilizar con Claude Code, utilice 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úrese de reemplazar los marcadores de posición con la cadena de conexión MongoDB real y el nombre de la base de datos predeterminada.
Si está configurado correctamente, debería ver lo siguiente cuando ejecute claude :
╭───────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code research preview! │
│ │
│ /help for help │
│ │
│ cwd: <path-to-project-directory> │
│ │
│ ─────────────────────────────────────────────────── │
│ │
│ MCP Servers: │
│ │
│ • mongo-server connected │
╰───────────────────────────────────────────────────────╯
Si tiene algún problema, consulte 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 confidencial
- Almacenar cadenas de conexión de forma segura en variables de entorno
- Utilice un usuario 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 complicada. Utilice el Inspector MCP , disponible como script de paquete:
El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.