Enables GitHub Copilot to interact with MongoDB databases through the MCP server, allowing natural language queries and operations against MongoDB resources.
Provides tools for interacting with MongoDB Atlas resources and databases, supporting operations like querying, aggregation, document creation/modification, collection management, index creation, and database administration.
Un servidor de protocolo de contexto de modelo para interactuar con bases de datos MongoDB y MongoDB Atlas.
La mayoría de los clientes MCP requieren que se cree o modifique un archivo de configuración para agregar el servidor MCP.
Puede pasar su cadena de conexión a través de argumentos, asegúrese de utilizar un nombre de usuario y contraseña válidos.
Use las credenciales de su cuenta de servicio Atlas API. Más información en la sección Acceso a la API de Atlas .
Alternativamente, puede utilizar variables de entorno en el archivo de configuración o configurarlas y ejecutar el servidor a través de npx.
atlas-list-orgs - Listas de organizaciones de MongoDB Atlasatlas-list-projects - Lista de proyectos de MongoDB Atlasatlas-create-project : crea un nuevo proyecto Atlas de MongoDBatlas-list-clusters : lista los clústeres de MongoDB Atlasatlas-inspect-cluster : inspecciona un clúster específico de MongoDB Atlasatlas-create-free-cluster : crea un clúster gratuito de MongoDB Atlasatlas-connect-cluster : se conecta al clúster Atlas de MongoDBatlas-inspect-access-list : Inspeccione rangos de IP/CIDR con acceso a clústeres de MongoDB Atlasatlas-create-access-list : configura la lista de acceso IP/CIDR para clústeres de MongoDB Atlasatlas-list-db-users - Lista de usuarios de la base de datos Atlas de MongoDBatlas-create-db-user : enumera los usuarios de la base de datos Atlas de MongoDBNOTA: las herramientas de atlas solo están disponibles cuando configura las credenciales en la sección de configuración .
connect - Conectarse a una instancia de MongoDBfind - Ejecuta una consulta de búsqueda en una colección de MongoDBaggregate - Ejecutar una agregación contra una colección de MongoDBcount - Obtener la cantidad de documentos en una colección de MongoDBinsert-one - Inserta un solo documento en una colección MongoDBinsert-many : inserta varios documentos en una colección MongoDBcreate-index : crea un índice para una colección de MongoDBupdate-one - Actualizar un solo documento en una colección de MongoDBupdate-many : actualiza varios documentos en una colección de MongoDBrename-collection - Cambiar el nombre de una colección de MongoDBdelete-one : elimina un solo documento de una colección de MongoDBdelete-many : elimina varios documentos de una colección MongoDBdrop-collection - Eliminar una colección de una base de datos MongoDBdrop-database - Eliminar una base de datos MongoDBlist-databases : enumera todas las bases de datos para una conexión MongoDBlist-collections : enumera todas las colecciones de una base de datos determinadacollection-indexes : describe los índices de una coleccióncollection-schema : Describe el esquema de una coleccióncollection-storage-size : obtiene el tamaño de una colección en MBdb-stats : devuelve estadísticas sobre una base de datos MongoDBEl servidor MongoDB MCP se puede configurar utilizando varios métodos, con la siguiente precedencia (de mayor a menor):
| Opción | Descripción |
|---|---|
apiClientId | ID de cliente de la API de Atlas para autenticación |
apiClientSecret | Secreto del cliente de la API de Atlas para la autenticación |
connectionString | Cadena de conexión MongoDB para conexiones directas a bases de datos (los usuarios opcionales pueden optar por informarlo en cada llamada a la herramienta) |
logPath | Carpeta para almacenar registros |
disabledTools | Una matriz de nombres de herramientas, tipos de operaciones y/o categorías de herramientas que se deshabilitarán |
readOnly | Cuando se establece como verdadero, solo permite los tipos de operaciones de lectura y metadatos, y deshabilita las operaciones de creación, actualización y eliminación. |
telemetry | Cuando se configura como deshabilitado, deshabilita la recopilación de telemetría. |
La ubicación del registro predeterminada es la siguiente:
%LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs~/.mongodb/mongodb-mcp/.app-logsPuede deshabilitar herramientas específicas o categorías de herramientas mediante la opción disabledTools . Esta opción acepta una matriz de cadenas, donde cada cadena puede ser el nombre de una herramienta, un tipo de operación o una categoría.
La forma en que se construye la matriz depende del tipo de método de configuración que utilice:
export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema" .--disabledTools create update delete atlas collectionSchema .Categorías de herramientas:
atlas - Herramientas Atlas de MongoDB, como listar clústeres, crear clústeres, etc.mongodb : herramientas de base de datos MongoDB, como búsqueda, agregación, etc.Tipos de operación:
create - Herramientas que crean recursos, como crear clúster, insertar documento, etc.update - Herramientas que actualizan recursos, como actualizar documentos, cambiar el nombre de una colección, etc.delete - Herramientas que eliminan recursos, como eliminar documento, eliminar colección, etc.read : herramientas que leen recursos, como buscar, agregar, enumerar clústeres, etc.metadata : herramientas que leen metadatos, como bases de datos de listas, colecciones de listas, esquemas de colecciones, etc.La opción de configuración readOnly permite restringir el servidor MCP para que solo use herramientas con operaciones de lectura y metadatos. Al habilitarla, las herramientas con operaciones de creación, actualización o eliminación no se registrarán en el servidor.
Esto es útil para escenarios en los que desea proporcionar acceso a los datos de MongoDB para su análisis sin permitir ninguna modificación en los datos o la infraestructura.
Puede habilitar el modo de solo lectura usando:
export MDB_MCP_READ_ONLY=true--readOnlyCuando el modo de solo lectura está activo, verá un mensaje en los registros del servidor que indica qué herramientas no pudieron registrarse debido a esta restricción.
La opción de configuración telemetry permite deshabilitar la recopilación de datos de telemetría. Al habilitarla, el servidor MCP recopilará datos de uso y los enviará a MongoDB.
Puede desactivar la telemetría mediante:
export MDB_MCP_TELEMETRY=disabled--telemetry disabledexport DO_NOT_TRACK=1Para utilizar las herramientas de la API de Atlas, deberá crear una cuenta de servicio en MongoDB Atlas:
Para obtener más información sobre las cuentas de servicio, consulte la documentación de MongoDB Atlas .
apiClientId y apiClientSecretEstablezca las variables de entorno con el prefijo MDB_MCP_ seguido del nombre de la opción en mayúsculas y guiones bajos:
Pase las opciones de configuración como argumentos de la línea de comandos al iniciar el servidor:
¿Te interesa contribuir? ¡Genial! Consulta nuestra Guía de Contribución para obtener información sobre contribuciones de código, estándares, nuevas herramientas e información para la resolución de problemas.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA interactuar con los recursos de MongoDB Atlas a través del lenguaje natural, respaldando las operaciones de base de datos y las funciones de gestión de Atlas.