O servidor MongoDB MCP permite a interação com clusters MongoDB usando queries de linguagem natural de clientes de IA com suporte a MCP. Esta página descreve as ferramentas do servidor MCP.
Visão geral
O servidor MongoDB MCP fornece as seguintes categorias de ferramentas:
Ferramentas do Atlas, que executam operações nos recursos do sistema do Atlas, como organizações, projetos, clusters, contas de usuário de banco de dados e recuperação de recomendações de desempenho.
Ferramentas locais do Atlas, que permitem listar, conectar, criar e excluir implantações locais do Atlas.
FERRAMENTAS de banco de dados, que executam operações como inserção, atualização e exclusão de documentos, e execução de queries e pipelines de agregação.
Atlas do servidor MCP FERRAMENTAS
As FERRAMENTAS do Atlas só estarão disponíveis se você tiver configurado as credenciais da API do Atlas, conforme mostrado em Configuração do servidor MCP do MongoDB.
A tabela seguinte descreve o Atlas FERRAMENTAS:
Nome da ferramenta Atlas do servidor MCP | Descrição |
|---|---|
| Retorna uma lista de organizações do Atlas . |
| Retorna uma lista de projetos do Atlas . |
| Cria um novo projeto Atlas . |
| Retorna a lista de Atlas clusters. |
| Retorna informações sobre um Atlas cluster específico. |
| Cria um Atlas cluster gratuito. |
| Conecta-se a um cluster Atlas usando a conta de serviço configurada. Se você configurou o servidor MCP sem especificar uma string de conexão, esta ferramenta criará um usuário de banco de dados temporário com uma senha aleatória para estabelecer a conexão. Para obter detalhes, consulte Detalhes da ferramenta. |
| Retorna informações sobre os intervalos IP e CIDR que podem acessar um cluster do Atlas . |
| Configura a lista de acesso IP e CIDR para um cluster Atlas. |
| Retorna uma lista de usuários do banco de dados do Atlas . |
| Cria um usuário de banco de dados Atlas . |
| Retorna uma lista de alertas para um projeto Atlas . |
| Retorna recomendações do Performance Advisor para um cluster Atlas . Oferece suporte a operações para índices sugeridos, sugestões de descarte de índices, logs de query lenta e sugestões de esquema. Requer acesso Para aprendermais, consulte a ferramenta Performance Advisor. |
Ferramentas locais do Atlas do servidor MCP
Você pode utilizar o servidor MCP com implantações locais do Atlas. Para usar as FERRAMENTAS do servidor MCP com implantações locais do Atlas, você deve instalar o Docker. Para uma introdução às implantações locais do Atlas, consulte Criar uma implantação local do Atlas.
A tabela seguinte descreve as ferramentas Atlas locais:
Nome da ferramenta Atlas local do servidor MCP | Descrição |
|---|---|
| Lista implantações locais do Atlas. |
| Cria uma implantação local do Atlas. Para executar esta ferramenta, você deve desativar o modo somente leitura. |
| Conecta a uma implantação local do Atlas. |
| Exclui uma implantação local do Atlas. Para executar esta ferramenta, você deve desativar o modo somente leitura. |
Para exemplos que executam as FERRAMENTAS locais do Atlas, consulte Implantações locais do Atlas.
Database Tools do Servidor MCP
A tabela a seguir descreve as ferramentas do banco de dados :
Nome da ferramenta de banco de dados do servidor MCP | Descrição |
|---|---|
| Conecta a um cluster MongoDB . |
| Executa uma query de banco de dados MongoDB . |
| Executa um agregação pipeline MongoDB . |
| Retorna o número de documentos em uma coleção. |
| Retorna estatísticas descrevendo a execução do plano vencedor escolhido pelo otimizador de query para o método avaliado. |
| Adiciona documentos a uma collection. Se você especificar uma chave de API do Voyage AI na configuração do MCP, o servidor poderá gerar automaticamente incorporações vetoriais a partir do texto e incluí-las nos documentos inseridos. |
| Cria um índice em uma coleção. Esta ferramenta oferece suporte à criação de índices de pesquisa vetorial. |
| Remove um índice de pesquisa vetorial de uma collection. |
| Modifica um único documento em uma coleção. |
| Modifica vários documentos em uma coleção. |
| Altera o nome de uma coleção. |
| Cria uma nova collection. |
| Remove documentos de uma collection. |
| Exclui uma collection de um banco de dados. |
| Exclui um banco de dados. |
| Solte um índice para o banco de dados e a coleção fornecidos. |
| Retorna uma lista de todos os bancos de dados disponíveis através da conexão atual. |
| Retorna uma lista de collections em um banco de dados. |
| Retorna informações sobre índices de coleção, incluindo índices de pesquisa vetorial. |
| Retorna informações do esquema de collection. |
| Retorna o tamanho da coleção em megabytes. |
| Retorna estatísticas do banco de dados . |
| Salva os resultados de uma query ou agregação pipeline no formato JSON em um arquivo no computador que executa o servidor MCP. Os resultados também podem ser acessados por meio do recurso |
| Retorna os eventos |
| Mude para uma conexão MongoDB diferente. |
Detalhes da ferramenta
Para obter informações adicionais sobre ferramentas específicas de MCP, consulte as seções a seguir.
Suporte a Vector Search
O suporte de pesquisa vetorial no MCP está disponível como um recurso de visualização. Para habilitar esse recurso, defina o previewFeatures sinalizador ou a MDB_MCP_PREVIEW_FEATURES variável de ambiente como search em sua configuração de MCP. Para saber mais, consulte Opções de configuração do servidor MongoDB MCP.
O servidor do MongoDB MCP oferece suporte ao MongoDB Vector Search. Você pode criar e gerenciar índices de pesquisa vetorial, gerar embeddings e executar query de pesquisa semântica por meio de prompts de linguagem natural. A tabela a seguir resume os principais recursos.
Caso de uso | Exemplo de prompts | Ferramentas relevantes |
|---|---|---|
Gerenciar índices | Create a vector search index on the sample_db database and products collectionShow me all vector search indexes on the products collectionDrop the vector search index named vector_index | create-indexcollection-indexesdrop-index |
Inserir documentos com incorporações automáticas | Insert these documents into the products collection and embed their descriptions | insert-many |
Queries de pesquisa vetorial | Search for documents semantically similar to this descriptionFind me related products filtered by price range | aggregate |
Use os seguintes recursos para saber mais:
Para obter exemplos de uso detalhados e amostras de saída, consulte Vector Search.
Para configurar o servidor MCP para pesquisa vetorial, consulte Opções de Vector Search .
Para saber mais sobre a pesquisa vetorial, consulte Visão geral da Vector Search do MongoDB .
Gerenciamento de índices
As seguintes ferramentas permitem gerenciar índices de pesquisa vetorial:
collection-indexes: lista todos os índices em uma collection, incluindo índices de pesquisa vetorial, e fornece informações de status do índice.create-index: cria um novo índice de pesquisa vetorial em uma coleção.drop-index: Exclui um índice de pesquisa vetorial de uma collection.
Observação
Para atualizar um índice de pesquisa vetorial, solte o índice existente e crie um novo.
Geração automática de incorporação
Se você configurar o servidor MCP com uma chave de API do Voyage AI, o servidor poderá gerar automaticamente incorporações das seguintes maneiras:
Gerar incorporações para documentos: incorpora campos de texto em documentos ao usar a
insert-manyferramenta.Gera incorporações para queries: Incorpora a query de pesquisa ao executar consultas de pesquisa vetorial com a
aggregateferramenta. Especificamente, o servidor gera incorporações para oqueryVectorparâmetro em queries$vectorSearchde agregação do.
O servidor MCP é compatível com os seguintes modelos de incorporação do Voyage AI:
voyage-3-largevoyage-3.5voyage-3.5-litevoyage-code-3
Para saber mais sobre os modelos de IA do Voyage, consulte a documentação de IA do Voyage.
Observação
Por padrão, o servidor MongoDB MCP valida que os campos com índices de pesquisa vetorial contêm incorporações de vetor válidas para evitar a quebra de índices de pesquisa vetorial. Para desabilitar este comportamento, defina disableEmbeddingsValidation a true opção como. Para saber mais, consulte Opções de Vector Search .
Considerações
O servidor MongoDB MCP oferece suporte à pré-filtragem de query de pesquisa vetorial. Para saber mais, consulte Pré-filtragem de Vector Search do MongoDB .
O servidor MCP não suporta o campo quantization para índices de pesquisa vetorial.
Ferramenta Performance Advisor
A ferramenta atlas-get-performance-advisor permite acessar as recomendações do Performance Advisor por meio de querys de linguagem natural. Essa ferramenta ajuda você a identificar oportunidades de otimização de desempenho, analisando queries lentas e sugerindo melhorias.
Ao realizar a análise de query lenta, o servidor MongoDB MCP recupera uma amostra de queries lentas, limitada a 50 queries. A amostra inclui até 50 queries lentas mais recentes que correspondem a quaisquer condições especificadas em seu prompt para garantir o desempenho e os tempos de resposta ideais.
Observação
Esta ferramenta requer acessoProject Read Only ou superior e um cluster M10+. Ele está disponível com a bandeira --readonly.
Caso de uso | Exemplo de prompts | Operação do Performance Advisor |
|---|---|---|
Analisar queries lentas | Show me my slow queriesWhat is slowing down my cluster?Show me queries that are longer than 5 secondsShow me slow writes in the website.users namespace | |
Sugestões de Índices | Are there any indexes I should create to improve performance?What indexes do you recommend I drop? | |
Conselho sobre o esquema | Show schema recommendations for my clusterHelp me optimize my database schema |
Para obter exemplos de uso detalhados e amostras de saída, consulte Otimização de desempenho.
Conectando sem Atlas string de conexão
Se você configurar o servidor MCP sem especificar uma string de conexão para um Atlas cluster, a atlas-connect-cluster ferramenta criará um usuário de banco de dados temporário para estabelecer conexão com o cluster utilizando as credenciais de conta de serviço configuradas do Atlas API.
O usuário de banco de dados temporário tem as seguintes características:
Nome de usuário e senha gerados aleatoriamente.
Expira automaticamente após 12 horas.
Função atribuída com base em como você configurou o servidor MCP:
readAnyDatabasese você ativou o modo somente leitura ou desativou as categorias de ferramentascreate,deleteeupdate.readWriteAnyDatabasese o servidor tiver permissões completas.
Observação
O Servidor MongoDB MCP armazena credenciais de usuário apenas na memória e nunca retorna ou expõe as credenciais no contexto LLM.
Saiba mais
Para desabilitar FERRAMENTAS específicos e restringir o servidor MCP ao modo somente leitura, consulte Configuração do servidor MCP do MongoDB.
Para ver alguns exemplo de prompts de linguagem natural do servidor MCP, consulte Exemplos de uso do servidor MCP do MongoDB.