MongoDB

Servidor MCP MongoDB

Um servidor Model Context Protocol que fornece acesso somente leitura a bancos de dados MongoDB por meio de ferramentas e recursos MCP padronizados.

Visão Geral

Este servidor MCP MongoDB permite que assistentes de IA consultem e analisem diretamente bancos de dados MongoDB sem acesso de escrita, mantendo a segurança dos dados enquanto oferece poderosas capacidades de exploração de dados.

Recursos

Operações MongoDB

• Exploração de Banco de Dados: Liste bancos de dados e coleções
• Descoberta de Esquema: Infira esquemas de coleções a partir de documentos de amostra
• Consultas: Execute consultas MongoDB com filtragem, projeção, ordenação e limitação
• Agregação: Execute pipelines de agregação somente leitura com validação de segurança
• Pesquisa de Texto: Realize pesquisa de texto completo em coleções com índices de texto
• Consultas Geoespaciais: Encontre locais próximos a pontos, dentro de polígonos ou que intersectem geometrias
• Operações de Documentos: Conte documentos, amostre documentos aleatórios, encontre documentos por IDs
• Análise de Dados: Obtenha estatísticas de coleções, informações de índices e planos de execução de consultas
• Insights de Desempenho: Examine planos de execução de consultas para otimizar o desempenho
• Exploração de Dados: Obtenha valores distintos, distribuições de campos e amostras de dados
• Conversão de Formato: Exporte resultados de consultas nos formatos JSON ou CSV

Capacidades Aprimoradas

• Inferência de Esquema: Detecte automaticamente tipos de dados e estrutura a partir de documentos
• Sugestões de Visualização: Sugestões inteligentes para visualização de dados com base no conteúdo dos resultados
• Validação de Segurança: Impede operações de escrita em pipelines de agregação
• Documentação Rica em Exemplos: Cada ferramenta inclui exemplos detalhados em sua descrição

Requisitos

Variáveis de Ambiente

• MONGODB_URI (obrigatório): String de conexão MongoDB com autenticação, se necessário
• MONGODB_DEFAULT_DATABASE (opcional): Nome padrão do banco de dados quando não especificado nas consultas

Pré-requisitos

• Acesso de rede ao servidor MongoDB
• Credenciais de autenticação, se exigidas pela instância MongoDB
• Permissões de leitura apropriadas nos bancos de dados de destino

Instalação

Compilação a partir do Código Fonte

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Integração 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": {
    "mongodb": {
      "command": "/path/to/mongodb-server/build/index.js",
      "env": {
        "MONGODB_URI": "mongodb://username:password@hostname:port/database",
        "MONGODB_DEFAULT_DATABASE": "your_default_db"
      }
    }
  }
}

Integração com Claude Web

Para Claude Web por meio da extensão MCP Chrome, adicione a configuração às configurações MCP do Cline:

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": ["/path/to/mongodb-server/build/index.js"],
      "env": {
        "MONGODB_URI": "mongodb://username:password@hostname:port/database",
        "MONGODB_DEFAULT_DATABASE": "your_default_db"
      }
    }
  }
}

Integração com Claude Code

Para usar com Claude Code, use os seguintes comandos:

cd /path/to/my/project
claude mcp add mongo-server /path/to/mongodb-mcp/build/index.js -e "MONGODB_URI=mongodb://user@password:27017/dbname?authSource=authDbName" -e MONGO_DEFAULT_DATABASE=dbname 

Certifique-se de substituir os espaços reservados pela sua string de conexão MongoDB real e pelo nome padrão do banco de dados.

Se configurado corretamente, você deverá ver o seguinte ao executar claude:

╭───────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code research preview!            │
│                                                       │
│   /help for help                                      │
│                                                       │
│   cwd: <path-to-project-directory>                    │
│                                                       │
│   ─────────────────────────────────────────────────── │
│                                                       │
│   MCP Servers:                                        │
│                                                       │
│   • mongo-server                            connected │
╰───────────────────────────────────────────────────────╯

Se você encontrar problemas, consulte a documentação do Claude Code.

Considerações de Segurança

• Este servidor fornece acesso somente leitura por design
• Strings de conexão podem conter informações sensíveis de autenticação
• Armazene strings de conexão com segurança em variáveis de ambiente
• Use um usuário MongoDB com permissões somente leitura

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Use o MCP Inspector, que está disponível como um script de pacote:

npm run inspector

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