MongoDB Atlas MCP Server

📢 AVISO DE SERVIDOR DA COMUNIDADE
Este é um MCP Server mantido pela comunidade.
👉 Para o oficial MongoDB MCP Server, visite mongodb-js/mongodb-mcp-server

MongoDB Atlas MCP Server

Um servidor MCP (Model Context Protocol) para gerenciar projetos MongoDB Atlas. Este pacote fornece ferramentas para criar e gerenciar clusters, usuários e acesso à rede do MongoDB Atlas por meio da interface MCP.

Vídeo de Demonstração

Assista ao vídeo de demonstração para ver o MongoDB Atlas MCP Server em ação.

Recursos

Ferramentas MCP

• create_atlas_cluster - Criar um novo cluster MongoDB Atlas em um projeto existente
• setup_atlas_network_access - Configurar acesso à rede para um projeto Atlas
• create_atlas_user - Criar um novo usuário de banco de dados com a função atlasAdmin
• get_atlas_connection_strings - Recuperar strings de conexão para um cluster
• list_atlas_projects - Listar todos os projetos Atlas acessíveis com a chave de API fornecida
• list_atlas_clusters - Listar todos os clusters em um projeto Atlas específico

Instalação

npm install mcp-mongodb-atlas

Uso

Como Ferramenta de Linha de Comando

Você pode executar o Atlas Project Manager diretamente da linha de comando:

# 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"

Com Cline (Extensão do VSCode)

Para usar com Cline no VSCode, adicione a configuração do servidor ao seu arquivo de configurações 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": []
    }
  }
}

O arquivo de configurações MCP está localizado em:

• 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

Com Cursor

Para usar com Cursor, vá para "Configurações do Cursor" > "MCP" nas configurações e adicione um novo servidor com a seguinte configuração:

1. Nome: atlas (ou qualquer nome de sua preferência)
2. Comando: npx mcp-mongodb-atlas
3. Argumentos: forneça suas chaves de API como argumentos

## Suggested Command
npx mcp-mongodb-atlas <public_key> <private_key>

Versões mais recentes podem definir o arquivo ~/.cursor/mcp.json com:

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

4. Variáveis de Ambiente (Opcional):
   • ATLAS_PUBLIC_KEY: Sua chave pública do MongoDB Atlas
   • ATLAS_PRIVATE_KEY: Sua chave privada do MongoDB Atlas

Com Claude Desktop

Para usar com Claude Desktop, adicione a configuração do servidor:

No macOS: ~/Library/Application Support/Claude/claude_desktop_config.json No 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"
      }
    }
  }
}

Chaves de API

Você precisa de chaves de API do MongoDB Atlas para usar esta ferramenta. Para criar chaves de API:

1. Faça login na sua conta do MongoDB Atlas
2. Vá para Access Manager > API Keys
3. Crie uma nova chave de API com as permissões apropriadas
4. Salve as chaves pública e privada

Desenvolvimento

Clone o repositório e instale as dependências:

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

Compile o projeto:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.

Licença

MIT