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.

Related MCP server: MongoDB MCP Server for LLMs

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 necesario
MONGODB_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:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

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:

npm run inspector

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

MongoDB MCP Server