Cómo Instalar y Configurar Servidor MongoDB MCP

En el panorama en constante evolución del desarrollo de software, la integración de la Inteligencia Artificial ya no es un concepto futurista, sino una realidad actual. Las herramientas impulsadas por IA se están volviendo rápidamente indispensables para los desarrolladores, agilizando los flujos de trabajo y mejorando la productividad. Reconociendo esta tendencia, MongoDB ha introducido una herramienta innovadora que cierra la brecha entre su base de datos y la IA: el Servidor del Protocolo de Contexto de Modelo (MCP) de MongoDB. Este tutorial proporciona una guía completa, paso a paso, para instalar y configurar el Servidor MCP de MongoDB, permitiéndole aprovechar todo el potencial de la IA en su entorno de desarrollo.

💡

¿Quiere una excelente herramienta de Pruebas de API que genere hermosa Documentación de API?

¿Quiere una plataforma integrada, Todo en Uno, para que su Equipo de Desarrolladores trabaje en conjunto con máxima productividad?

¡Apidog cumple todas sus demandas y reemplaza a Postman a un precio mucho más asequible!

button

¿Qué es el Servidor MCP de MongoDB?

El Servidor MCP de MongoDB es una nueva y potente herramienta diseñada para conectar sus implementaciones de MongoDB con una variedad de clientes impulsados por IA que soportan el Protocolo de Contexto de Modelo (MCP). Ya sea que esté utilizando MongoDB Atlas, la base de datos en la nube completamente gestionada, o una edición Community o Enterprise Advanced autohospedada, el Servidor MCP permite una interacción fluida con sus datos utilizando lenguaje natural. Esto significa que puede realizar una amplia gama de operaciones de base de datos, desde simples consultas de datos hasta complejas tareas administrativas, todo a través de comandos intuitivos y conversacionales dentro de sus herramientas de desarrollo de IA favoritas.

El MCP es un estándar abierto, introducido inicialmente por Anthropic, que está ganando rápidamente terreno por su capacidad para crear una capa de comunicación estandarizada entre agentes de IA y diversos sistemas de datos. Al implementar este protocolo, MongoDB se asegura de que sus usuarios puedan mantenerse a la vanguardia del desarrollo impulsado por IA. El Servidor MCP facilita un canal de comunicación bidireccional, permitiéndole no solo consultar sus datos, sino también proporcionar a sus Modelos de Lenguaje Grandes (LLMs) la información más actual y contextualmente relevante de su base de datos. Esto cambia las reglas del juego para tareas como la exploración de datos, la administración de bases de datos y la generación de código consciente del contexto.

El Servidor MCP de MongoDB soporta un ecosistema creciente de clientes MCP, incluyendo:

Windsurf: Un editor de código nativo de IA donde el servidor MCP está disponible de forma predeterminada.
Cursor: Un popular editor de código impulsado por IA.
GitHub Copilot en Visual Studio Code: Llevando el poder de su base de datos al IDE más popular del mundo.
Claude de Anthropic: Interactúe con su base de datos directamente desde la aplicación de escritorio de Claude.

¡Empecemos!

Requisitos previos

Antes de sumergirnos en el proceso de instalación, hay algunos requisitos previos que debe tener:

Node.js y npx: El Servidor MCP de MongoDB es una aplicación Node.js y se instala y ejecuta típicamente usando npx, el ejecutor de paquetes de Node.js. Necesitará tener Node.js versión 18 o superior instalado en su sistema. Puede verificar su versión de Node.js abriendo una terminal o línea de comandos y ejecutando node -v.
Cadena de conexión de MongoDB o credenciales de API de Atlas: Para conectarse a su base de datos, el Servidor MCP necesita una cadena de conexión estándar de MongoDB o credenciales de API para su cuenta de MongoDB Atlas.
Cadena de conexión: Este es el formato URI estándar para conectarse a una instancia de MongoDB. Incluye el nombre de usuario, contraseña, host, puerto y nombre de la base de datos.
Credenciales de API de Atlas: Si está utilizando MongoDB Atlas, puede crear una cuenta de servicio con los permisos necesarios y usar el ID de cliente de API y el secreto de cliente generados para la autenticación. Este método es necesario para usar las herramientas específicas de Atlas.
Un cliente MCP: Necesitará tener instalado uno de los clientes MCP soportados, como Cursor, Claude Desktop o Visual Studio Code con la extensión GitHub Copilot.
Docker (Opcional): Si prefiere ejecutar el Servidor MCP en un entorno contenedorizado, necesitará tener Docker y Docker Compose instalados. Esto es particularmente útil para pruebas locales en un entorno aislado y para evitar una instalación local de Node.js.

Instalación y configuración

El proceso de instalación y configuración del Servidor MCP de MongoDB varía ligeramente según el cliente MCP que esté utilizando. El núcleo del proceso implica agregar una configuración JSON al archivo de configuración de su cliente que le indica cómo iniciar y comunicarse con el servidor MCP.

El comando principal para ejecutar el servidor es npx -y mongodb-mcp-server. La bandera -y confirma automáticamente la instalación del paquete si aún no está presente.

Configuración en Cursor

Cursor es un editor de código centrado en IA que está ganando popularidad rápidamente. Así es como puede configurar el Servidor MCP de MongoDB en Cursor:

Abrir la configuración de Cursor: Inicie Cursor y haga clic en el icono de engranaje en la esquina superior derecha de la ventana para abrir la configuración.
Navegar a la sección MCP: En el panel de configuración de la izquierda, haga clic en "MCP".
Agregar un nuevo servidor MCP global: Haga clic en el botón "Add new global MCP server". Esto abrirá un archivo de configuración JSON.
Introducir la configuración: Copie y pegue la siguiente configuración JSON en el archivo. Deberá personalizar esto con sus detalles de conexión.

JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "environments": [
      {
        "name": "ATLAS_API_CLIENT_ID",
        "value": "your-atlas-api-client-id"
      },
      {
        "name": "ATLAS_API_CLIENT_SECRET",
        "value": "your-atlas-api-client-secret"
      }
    ]
  }
}

Si está utilizando una cadena de conexión en lugar de credenciales de API de Atlas, su configuración se verá así:JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

Guardar la configuración: Guarde el archivo. Cursor ahora podrá usar su nuevo Servidor MCP de MongoDB.

Con el servidor configurado, ahora puede interactuar con su base de datos utilizando lenguaje natural dentro de Cursor. Si ha utilizado sus credenciales de API de Atlas, tendrá acceso a un amplio conjunto de herramientas específicas de Atlas, lo que le permitirá crear clústeres gratuitos, administrar listas de acceso, crear usuarios de base de datos y mucho más. Si ha utilizado una cadena de conexión, tendrá acceso a herramientas para la administración de bases de datos, como listar bases de datos y colecciones, administrar índices y realizar operaciones CRUD (Crear, Leer, Actualizar, Eliminar).

Configuración en Claude Desktop

Si es usuario de Claude de Anthropic, puede integrar el Servidor MCP de MongoDB directamente en la aplicación de escritorio de Claude.

Abrir el archivo de configuración: Inicie la aplicación Claude Desktop, luego navegue a Settings > Developer > Edit Config. Esto abrirá el archivo claude_desktop_config.json en su editor de texto predeterminado. La ubicación de este archivo es típicamente:

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

Agregar la configuración del Servidor MCP: Agregue la siguiente configuración al objeto mcpServers en el archivo JSON.

JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/test"
      ]
    }
  }
}

Asegúrese de reemplazar la cadena de conexión de marcador de posición con su cadena de conexión real.

Reiniciar Claude Desktop: Cierre y reinicie la aplicación Claude Desktop.
Verificar el servidor: Haga clic en el icono del martillo en Claude Desktop. El Servidor MCP de MongoDB ahora debería aparecer como una herramienta disponible.

Configuración en Visual Studio Code con GitHub Copilot

Para los millones de desarrolladores que utilizan Visual Studio Code, el Servidor MCP de MongoDB se puede integrar con GitHub Copilot para llevar la interacción con la base de datos en lenguaje natural a su IDE favorito.

Abrir la paleta de comandos: Abra VS Code y presione Ctrl+Shift+P (o Cmd+Shift+P en macOS) para abrir la paleta de comandos.
Agregar un nuevo servidor MCP: Escriba "mcp" en la paleta de comandos y seleccione "MCP: Add Servers".
Elegir Command Standard I/O: Seleccione "Command Standard I/O" como tipo de servidor.
Introducir el comando: Introduzca el comando npx -y mongodb-mcp-server y déle un nombre a su servidor, por ejemplo, "mongodb".
Configurar en settings.json: Esto abrirá su archivo settings.json. Aquí, puede agregar sus argumentos y variables de entorno. Por ejemplo, para usar una cadena de conexión:

JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

O, para usar credenciales de API de Atlas:JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "options": {
      "env": {
        "ATLAS_API_CLIENT_ID": "your-atlas-api-client-id",
        "ATLAS_API_CLIENT_SECRET": "your-atlas-api-client-secret"
      }
    }
  }
}

Iniciar el servidor: Puede iniciar el servidor haciendo clic en el botón "Start" que aparece encima del nombre del servidor en su archivo settings.json, o abriendo la paleta de comandos, buscando "MCP: List Servers", seleccionando su servidor y luego seleccionando "Start Server".

Una vez que el servidor esté en funcionamiento, puede usar el modo de agente de GitHub Copilot para interactuar con su entorno MongoDB Atlas. Puede pedirle que liste sus proyectos, cree nuevos clústeres, administre usuarios y mucho más, todo desde dentro de VS Code.

Configuración avanzada

El Servidor MCP de MongoDB ofrece varias opciones de configuración avanzada para adaptar su comportamiento a sus necesidades específicas.

Modo de solo lectura

Para mayor seguridad, especialmente al conectarse a bases de datos de producción, puede ejecutar el servidor en modo de solo lectura. Esto evitará cualquier operación de escritura, como crear, actualizar o eliminar documentos. Puede habilitar el modo de solo lectura usando un argumento de línea de comandos:

npx mongodb-mcp-server --readOnly

O configurando una variable de entorno:

export MDB_MCP_READ_ONLY=true

Deshabilitar herramientas específicas

Puede deshabilitar herramientas específicas para restringir las capacidades del servidor. Esto es útil por seguridad o para simplificar los comandos disponibles. Puede deshabilitar herramientas usando el argumento de línea de comandos --disabledTools, seguido de una lista de nombres de herramientas separados por espacios.

npx mongodb-mcp-server --disabledTools create update delete atlas collectionSchema

Alternativamente, puede usar la variable de entorno MDB_MCP_DISABLED_TOOLS con una lista de nombres de herramientas separados por comas.

export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema"

Telemetría

Por defecto, el Servidor MCP de MongoDB recopila datos de uso anónimos para ayudar a mejorar el producto. Si desea deshabilitar esto, puede usar el argumento de línea de comandos --telemetry disabled o la variable de entorno MDB_MCP_TELEMETRY=disabled.

Instalación de Docker

Para aquellos que prefieren un entorno contenedorizado, el Servidor MCP de MongoDB se puede ejecutar en un contenedor Docker. Esto proporciona aislamiento y elimina la necesidad de una instalación local de Node.js.

Para ejecutar el servidor con una cadena de conexión:

docker run --rm -i -e MDB_MCP_CONNECTION_STRING="your-mongodb-connection-string" mongodb/mongodb-mcp-server:latest

Para ejecutar con credenciales de API de Atlas:

docker run --rm -i -e MDB_MCP_API_CLIENT_ID="your-atlas-api-client-id" -e MDB_MCP_API_CLIENT_SECRET="your-atlas-api-client-secret" mongodb/mongodb-mcp-server:latest

Luego, configuraría su cliente MCP para usar el comando docker en lugar de npx. Por ejemplo, en Claude Desktop:JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MDB_MCP_API_CLIENT_ID=your-atlas-api-client-id",
        "-e",
        "MDB_MCP_API_CLIENT_SECRET=your-atlas-api-client-secret",
        "mongodb/mongodb-mcp-server:latest"
      ]
    }
  }
}

Conclusión

El Servidor MCP de MongoDB representa un paso significativo en la integración de la IA y las bases de datos. Al proporcionar una forma estandarizada para que los clientes de IA interactúen con MongoDB, abre un mundo de posibilidades para los desarrolladores. Desde consultas en lenguaje natural y exploración de datos hasta administración de bases de datos asistida por IA y generación de código, el Servidor MCP está destinado a convertirse en una herramienta esencial en el kit de herramientas del desarrollador moderno.

Este tutorial ha proporcionado una guía completa para empezar con el Servidor MCP de MongoDB. Siguiendo estos pasos, puede conectar rápida y fácilmente sus implementaciones de MongoDB a sus herramientas de IA favoritas y comenzar a cosechar los beneficios del desarrollo impulsado por IA. Dado que esta es una tecnología nueva y en evolución, asegúrese de consultar la documentación oficial de MongoDB y el repositorio de GitHub para obtener las últimas actualizaciones y características. El futuro de la interacción con las bases de datos está aquí, y con el Servidor MCP de MongoDB, usted está a la vanguardia.

💡

button