El servidor MongoDB MCP le permite interactuar con clústeres MongoDB utilizando consultas en lenguaje natural desde clientes de IA que admiten MCP. Esta página describe las herramientas del servidor MCP.
Overview
El servidor MongoDB MCP proporciona las siguientes categorías de herramientas:
Herramientas Atlas, que realizan operaciones sobre recursos del sistema Atlas, como organizaciones, proyectos, clústeres, cuentas de usuario de base de datos y obtención de recomendaciones de rendimiento.
Herramientas de implementación de Atlas local, que permiten listar, conectar, crear y borrar implementaciones locales de Atlas.
Herramientas de asistente, que buscan en la Base de Conocimiento del asistente de MongoDB documentación oficial y orientación seleccionada.
Herramientas de base de datos, que ejecutan operaciones como insertar, actualizar y eliminar documentos, y ejecutar búsquedas y pipelines de agregación.
No todas las herramientas de Atlas y las herramientas de base de datos están disponibles tanto en el servidor MCP gestionado de MongoDB Atlas como en el servidor MCP local para MongoDB MCP Server. Las columnas gestionado de Atlas y local de cada una de estas tablas indican si un tipo de implementación de MCP admite una herramienta determinada.
Herramientas Atlas del Servidor MCP
Las herramientas de Atlas solo están disponibles si has configurado las credenciales de la API de Atlas como se describe en la Configuración del servidor MCP de MongoDB.
La siguiente tabla describe las herramientas de Atlas. Las columnas Atlas Managed y Local indican si cada herramienta está disponible en el servidor MCP gestionado de MongoDB Atlas y en el MCP local para el servidor MCP de MongoDB, respectivamente.
Nombre de la herramienta Atlas | Descripción | Atlas gestionado | Local |
|---|---|---|---|
| Devuelve una lista de organizaciones de Atlas. | ||
| Devuelve una lista de proyectos de Atlas. | ||
| Crea un nuevo proyecto Atlas. | ||
| Devuelve la lista de clústeres de Atlas. | ||
| Devuelve información sobre un clúster específico de Atlas. | ||
| Crea un clúster gratuito de Atlas. | ||
| Se conecta a un clúster Atlas usando la cuenta de servicio configurada. Si configuró el servidor MCP sin especificar una cadena de conexión, esta herramienta crea un usuario de base de datos temporal con una contraseña aleatoria para establecer la conexión. Para obtener más información, consulte la sección Detalles de la herramienta. | ||
| Soporta las siguientes actualizaciones de clúster de Atlas:
Opcionalmente, puedes especificar el | ||
| Crea un clúster de Atlas dedicado con tamaños de instancia M10–M80. Admite tipos de clúster de set de réplicas y de partición única en una a tres regiones.
| ||
| Pausa o reanuda un clúster Atlas dedicado (M10+). Los clúster gratuitos y Flex no se pueden pausar.
| ||
| Devuelve información sobre los rangos de IP y CIDR que pueden acceder a un clúster Atlas. | ||
| Configura la lista de acceso IP y CIDR para un clúster Atlas. | ||
| Devuelve una lista de usuarios de base de datos Atlas. | ||
| Crea un usuario de base de datos de Atlas. | ||
| Devuelve una lista de alertas para un proyecto de Atlas. | ||
| Retorna Recomendaciones del Performance Advisor para un clúster de Atlas. Admite operaciones para índices sugeridos, sugerencias de eliminación de índice, registros de consultas lentas y sugerencias de esquemas. Se requiere acceso Para obtener más información, consulte la herramienta de asesoramiento sobre rendimiento. | ||
| Carga un conjunto de datos de muestra en un clúster de Atlas. | ||
| Se conecta a un clúster de Atlas en el servidor MCP remoto. | ||
| Devuelve información sobre un espacio de trabajo de Atlas Stream Processing, un procesador, una conexión pública o una conexión de red privatelink. En el servidor MCP remoto, las herramientas de Atlas Stream Processing se exponen a través de las herramientas | ||
| Crea un espacio de trabajo de Atlas Stream Processing, un procesador, una conexión pública o una conexión de red privatelink. | ||
| Gestiona un espacio de trabajo, procesador o conexión pública de Atlas Stream Processing. El MongoDB MCP servidor puede:
| ||
| Elimina un espacio de trabajo de Atlas Stream Processing, un procesador, una conexión pública o una conexión de red Privatelink. |
Herramientas de Atlas local del servidor MCP
Puede usar MCP servidor con implementaciones locales de Atlas. Para usar las herramientas del Servidor MCP con implementaciones locales de Atlas, debe instalar Docker. Para obtener una introducción a las implementaciones locales de Atlas, consulte Crear una implementación local de Atlas.
La siguiente tabla describe las herramientas locales de Atlas:
Nombre de la herramienta local del servidor MCP Atlas | Descripción |
|---|---|
| Lista las implementaciones locales de Atlas. |
| Crea una implementación local de Atlas. Para ejecutar esta herramienta, debes desactivar el modo de solo lectura. |
| Conexión a una implementación local de Atlas. |
| Elimina una implementación local de Atlas. Para ejecutar esta herramienta, debes desactivar el modo de solo lectura. |
Para obtener ejemplos que ejecutan las herramientas locales de Atlas, consulta Implementaciones locales de Atlas.
MCP Server Database Tools
La siguiente tabla describe las herramientas de base de datos. Las columnas Atlas gestionado y Local indican si cada herramienta está disponible en el servidor MCP gestionado de MongoDB Atlas y en el MCP local para el servidor MCP de MongoDB, respectivamente.
Nombre de la herramienta de base de datos | Descripción | Atlas gestionado | Local |
|---|---|---|---|
| Se conecta a un clúster de MongoDB. | ||
| Ejecuta una query de base de datos MongoDB. | ||
| Ejecuta una pipeline de agregación de MongoDB. | ||
| Ejecuta una pipeline de agregación de MongoDB a nivel de base de datos. | ||
| Devuelve el número de documentos en una colección. | ||
| Devuelve estadísticas que describen la ejecución del plan ganador elegido por el optimizador del query para el método evaluado. | ||
| Agrega documentos a una colección. | ||
| Crea un índice en una colección. Esta herramienta permite crear índices de búsqueda vectorial. | ||
| Elimine un índice para la base de datos y la colección proporcionadas. Esta herramienta admite la eliminación de índices de búsqueda vectorial. | ||
| Modifica un único documento en una colección. | ||
| Modifica múltiples documentos en una colección. | ||
| Cambia el nombre de una colección. | ||
| Crea una nueva colección. | ||
| Remueve documentos de una colección. | ||
| Elimina una colección de una base de datos. | ||
| Elimina una base de datos. | ||
| Devuelve una lista de todas las bases de datos disponibles a través de la conexión actual. | ||
| Devuelve una lista de colecciones en una base de datos. | ||
| Devuelve información sobre los índices de la colección, incluidos los índices de búsqueda vectorial. | ||
| Devuelve la información del esquema de la colección. | ||
| Devuelve el tamaño de la colección en megabytes. | ||
| Devuelve las estadísticas de la base de datos. | ||
| Guarda los resultados de una query o un pipeline de agregación en formato JSON en un archivo del equipo que ejecuta el servidor MCP. Los resultados también están disponibles a través del recurso | ||
| Devuelve los eventos | ||
| Cambiar a una conexión diferente de MongoDB. |
Herramientas del asistente del servidor MCP
Las herramientas del asistente le dan a su cliente de IA acceso a la base de conocimientos de MongoDB Assistant, que incluye documentación oficial de MongoDB, orientación experta seleccionada y otros recursos proporcionados por MongoDB. Estas herramientas permiten que su cliente de IA recupere información precisa de MongoDB específica de la versión en lugar de depender únicamente de sus datos de entrenamiento.
La siguiente tabla describe las herramientas del asistente:
Nombre de la herramienta de asistente del servidor MCP | Descripción |
|---|---|
| Enumera las fuentes de datos disponibles en la Base de Conocimiento de MongoDB Assistant. Utilice esto para explorar las fuentes de datos disponibles o para encontrar parámetros de filtro de búsqueda para usar en |
| Busca información en la Base de Conocimiento de MongoDB Assistant. La Base de Conocimiento incluye documentación oficial, orientación experta seleccionada y otros recursos proporcionados por MongoDB. Admite el filtro por fuente de datos y versión. |
Detalles de la herramienta
Para obtener información adicional sobre herramientas MCP específicas, consulta las siguientes secciones.
Soporte para búsqueda vectorial
El servidor MCP de MongoDB es compatible con MongoDB búsqueda vectorial. Puede crear y gestionar índices de búsqueda vectorial, generar incrustaciones y ejecutar queries de búsqueda semántica a través de indicaciones de lenguaje natural. La siguiente tabla resume las funcionalidades clave.
Caso de uso | Prompts de ejemplo | Herramientas relevantes |
|---|---|---|
Gestionar índices |
|
|
Insertar documentos con representaciones automática |
|
|
Consultas de búsqueda vectorial |
|
|
Utiliza los siguientes recursos para obtener más información:
Para obtener descripciones de las herramientas de base de datos utilizadas para la búsqueda vectorial, como
create-index,collection-indexes,drop-index,insert-manyyaggregate, consulte la tabla Herramientas de base de datos del servidor MCP.Para obtener ejemplos de uso detallados y salidas de muestra, consulta Búsqueda vectorial.
Para configurar el servidor MCP para la búsqueda vectorial, consulte voyageApiKey.
Para obtener más información sobre la búsqueda vectorial, consulta Descripción general de MongoDB Vector Search.
Soporte de Atlas Stream Processing
Puede utilizar el servidor MCP de MongoDB para interactuar con sus recursos de Atlas Stream Processing. Atlas Stream Processing le permite leer, guardar y transformar flujos de datos de forma continua utilizando las mismas operaciones de agregación utilizadas por las bases de datos de Atlas. Se le cobrará por todos los procesadores en ejecución.
Las herramientas de Atlas Stream Processing (atlas-streams-discover, atlas-streams-build, atlas-streams-manage y atlas-streams-teardown) están disponibles tanto en los servidores MCP locales como en los gestionados por Atlas. Para obtener descripciones de las herramientas, consulte la tabla Herramientas de Atlas del servidor MCP.
Para obtener más información, consulta Atlas Stream Processing.
Generar embeddings automáticamente
El Servidor MCP MongoDB admite dos mecanismos independientes para generar incrustaciones vectoriales:
Generación de incrustaciones en el servidor MCP: El servidor MCP genera incrustaciones del lado del cliente utilizando Voyage IA antes de enviar los documentos a MongoDB. Esto requiere una clave API de Voyage IA.
Incorporación automatizada de MongoDB: MongoDB crea automáticamente incorporaciones de datos en el servidor cuando se insertan o actualizan documentos. Para obtener más información, consulta Automatización de incrustaciones en MongoDB.
Estos mecanismos funcionan de forma independiente y se pueden utilizar juntos o por separado, según el caso de uso.
La generación de incrustación del servidor MCP requiere una clave de API de Voyage AI configurada en el servidor MCP local y, por lo tanto, solo está disponible en el servidor MCP local. La incrustación automatizada de MongoDB genera incrustaciones dentro de MongoDB y no depende de la configuración del servidor MCP.
Generación de incrustaciones del servidor MCP
Si configuras el servidor MCP con una clave API de Voyage IA, el servidor puede generar automáticamente incorporaciones de las siguientes maneras:
Generar incrustaciones para documentos: Inserta campos de texto en los documentos cuando se utiliza la herramienta
insert-many.Genera embeddings para consultas: Embebe la consulta de búsqueda al ejecutar búsquedas vectoriales con la herramienta
aggregate. Específicamente, el servidor genera incrustaciones para el parámetroqueryVectoren las consultas agregadas de$vectorSearch.
El Servidor MCP es compatible con los siguientes modelos de embedding de Voyage IA:
voyage-3-largevoyage-3.5voyage-3.5-litevoyage-code-3
Para obtener más información sobre los modelos de Voyage IA, consulte la documentación de Voyage IA.
Nota
Por defecto, el Servidor MCP de MongoDB valida que los campos con índices de búsqueda vectorial contengan incrustaciones vectoriales válidas para evitar romper los índices de búsqueda vectorial. Para deshabilitar este comportamiento, establezca la opción disableEmbeddingsValidation en true. Para obtener más información, consulte voyageApiKey.
Embedding automatizado de MongoDB
Importante
La incrustación automatizada en los índices de búsqueda vectorial está disponible como funcionalidad preliminar solo para MongoDB Community Edition v8.2 y versiones posteriores. La funcionalidad y la documentación correspondiente pueden cambiar en cualquier momento durante el periodo Preliminar.
MongoDB también puede generar automáticamente embeddings del lado del servidor cuando se insertan o actualizan documentos. Este enfoque no requiere una clave de API de Voyage IA en tu configuración de MCP porque la generación de embeddings ocurre dentro de MongoDB.
El servidor MongoDB MCP admite la gestión de índices de búsqueda vectorial con incorporación automatizada, que genera automáticamente incorporaciones para tus documentos. Puedes crear, descartar e inspeccionar índices de búsqueda vectorial con embedding automatizado mediante indicaciones en lenguaje natural. La siguiente tabla resume las funcionalidades clave.
Para obtener más información, consulta Integración automatizada.
Caso de uso | Herramientas relevantes | Prompts de ejemplo |
|---|---|---|
Gestionar índices |
| "Crea un índice de búsqueda vectorial de incrustación automática en el campo 'plot' del espacio de nombres 'mflix.movies' utilizando el modelo voyage-4-large." |
Insertar datos con embeddings |
| "Inserte estos documentos con los siguientes campos y genere automáticamente las incrustaciones..." |
Query con incrustaciones |
| "Ejecute una consulta de búsqueda vectorial en mflix.movies con el índice de incrustación automática en el campo 'plot'." |
Considerations
El Servidor MCP de MongoDB es compatible con el pre-filtrado de consultas de búsqueda vectorial. Para aprender más, consulta Pre-filtro.
El servidor MCP no es compatible con el campo quantization para los índices de búsqueda vectorial.
Performance Advisor Tool
La herramienta atlas-get-performance-advisor permite acceder a las recomendaciones de Performance Advisor mediante consultas en lenguaje natural. Esta herramienta te ayuda a identificar oportunidades para optimizar el rendimiento analizando consultas lentas y sugiriendo mejoras.
Al realizar un análisis de consultas lentas, el servidor MongoDB MCP recupera una muestra de consultas lentas, limitada a 50 consultas. La muestra incluye hasta 50 de las consultas lentas más recientes que cumplen cualquiera de las condiciones especificadas en tu solicitud, para garantizar un rendimiento y tiempos de respuesta óptimos.
Nota
Esta herramienta requiere acceso Project Read Only o superior y un clúster M10+. Ejecute esta herramienta con el indicador --readonly.
Project Read Only se refiere al rol a nivel de proyecto Atlas asignado a su cuenta de servicio, no a un rol de base de datos.
Caso de uso | Prompts de ejemplo | Operación de Performance Advisor |
|---|---|---|
Analizar consultas lentas |
| |
Sugerencias de índices |
| |
Consejo de esquema |
|
Para obtener ejemplos de uso detallados y resultados de muestra, consulta Optimización del rendimiento.
Conectar sin Atlas cadena de conexión
Esta sección describe el flujo atlas-connect-cluster del servidor MCP local. Si configura el servidor MCP local sin especificar una cadena de conexión con un clúster de Atlas, la herramienta atlas-connect-cluster utiliza las credenciales configuradas de la cuenta de servicio de la API de Atlas para crear un usuario de base de datos temporal y establecer una conexión con el clúster.
El servidor MCP remoto utiliza una herramienta diferente, remote-atlas-connect, que sigue su propio modelo de conexión y sesión y devuelve un identificador de conexión para las operaciones de base de datos posteriores.
El usuario temporal de la base de datos tiene las siguientes características:
Nombre de usuario y contraseña generados aleatoriamente.
Por defecto, caduca después de 4 horas.
Rol asignado en función de cómo configuraste el servidor MCP:
readAnyDatabasesi activaste el modo de solo lectura o inhabilitaste las categorías de herramientascreate,deleteyupdate.readWriteAnyDatabasesi el servidor tiene todos los permisos.
Nota
El servidor MongoDB MCP almacena las credenciales de usuario solo en la memoria y nunca devuelve ni expone las credenciales en el contexto del LLM.
Obtén más información
Para deshabilitar herramientas específicas y restringir el Servidor MCP al modo de solo lectura, consulta Configuración del Servidor MongoDB MCP.
Para ver algunos ejemplos de prompts en lenguaje natural para MCP servidor, consulta Ejemplos de uso de MongoDB MCP servidor.