MongoDB Atlas MCP Server

Gestiona proyectos de MongoDB Atlas, incluyendo la creación de clústeres, la administración de usuarios y la configuración de acceso a la red.

Documentación

📢 AVISO DE SERVIDOR COMUNITARIO
Este es un servidor MCP mantenido por la comunidad.
👉 Para el oficial servidor MCP de MongoDB, visita mongodb-js/mongodb-mcp-server

MongoDB Atlas MCP Server

Un servidor MCP (Protocolo de Contexto de Modelo) para gestionar proyectos de MongoDB Atlas. Este paquete proporciona herramientas para crear y gestionar clústeres, usuarios y acceso a la red de MongoDB Atlas a través de la interfaz MCP.

Video de demostración

MongoDB Atlas MCP Server Demo

Mira el video de demostración para ver MongoDB Atlas MCP Server en acción.

Características

Herramientas MCP

  • create_atlas_cluster - Crear un nuevo clúster de MongoDB Atlas en un proyecto existente
  • setup_atlas_network_access - Configurar el acceso a la red para un proyecto de Atlas
  • create_atlas_user - Crear un nuevo usuario de base de datos con el rol atlasAdmin
  • get_atlas_connection_strings - Recuperar cadenas de conexión para un clúster
  • list_atlas_projects - Listar todos los proyectos de Atlas accesibles con la clave API proporcionada
  • list_atlas_clusters - Listar todos los clústeres en un proyecto específico de Atlas

Instalación

npm install mcp-mongodb-atlas

Uso

Como herramienta de línea de comandos

Puedes ejecutar el Administrador de Proyectos de Atlas directamente desde la línea de comandos:

# Using environment variables
export ATLAS_PUBLIC_KEY="your-public-key"
export ATLAS_PRIVATE_KEY="your-private-key"
npx mcp-mongodb-atlas

# Or passing keys as arguments
npx mcp-mongodb-atlas "your-public-key" "your-private-key"

Con Cline (Extensión de VSCode)

Para usar con Cline en VSCode, agrega la configuración del servidor a tu archivo de configuración de MCP:

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",
        "ATLAS_PRIVATE_KEY": "your-private-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

El archivo de configuración de MCP se encuentra en:

  • macOS: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • Windows: %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
  • Linux: ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

Con Cursor

Para usar con Cursor, ve a "Configuración de Cursor" > "MCP" en la configuración y agrega un nuevo servidor con la siguiente configuración:

  1. Nombre: atlas (o cualquier nombre que prefieras)
  2. Comando: npx mcp-mongodb-atlas
  3. Argumentos: proporciona tus claves API como argumentos
## Suggested Command
npx mcp-mongodb-atlas <public_key> <private_key>

Las versiones más recientes pueden configurar el archivo ~/.cursor/mcp.json con:

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",
        "ATLAS_PRIVATE_KEY": "your-private-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
  1. Variables de entorno (Opcional):
    • ATLAS_PUBLIC_KEY: Tu clave pública de MongoDB Atlas
    • ATLAS_PRIVATE_KEY: Tu clave privada de MongoDB Atlas

Con Claude Desktop

Para usar con Claude Desktop, agrega la configuración del servidor:

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

{
  "mcpServers": {
    "atlas": {
      "command": "npx",
      "args": ["mcp-mongodb-atlas"],
      "env": {
        "ATLAS_PUBLIC_KEY": "your-public-key",
        "ATLAS_PRIVATE_KEY": "your-private-key"
      }
    }
  }
}

Claves API

Necesitas claves API de MongoDB Atlas para usar esta herramienta. Para crear claves API:

  1. Inicia sesión en tu cuenta de MongoDB Atlas
  2. Ve a Administrador de Acceso > Claves API
  3. Crea una nueva clave API con los permisos adecuados
  4. Guarda las claves pública y privada

Desarrollo

Clona el repositorio e instala las dependencias:

git clone https://github.com/mongodb-developer/mcp-mongodb-atlas.git
cd mcp-mongodb-atlas
npm install

Compila el proyecto:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP:

npm run inspector

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

Licencia

MIT