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 pipeline de agregação 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 coleção. Se você especificar uma chave de API do Voyage IA 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 coleção. |
| 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 coleção. |
| Remove documentos de uma collection. |
| Exclui uma collection de um banco de dados. |
| Exclui um banco de dados. |
| Descarte 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 pesquisa vetorial
Importante
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.
O servidor MongoDB MCP oferece suporte à pesquisa vetorial MongoDB. 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 vetoriais | Search for documents semantically similar to this descriptionFind me related products filtered by price range | aggregate |
Use os seguintes recursos para aprender mais:
Para obter exemplos de uso detalhados e amostras de saída, consulte pesquisa vetorial.
Para configurar o servidor MCP para pesquisa vetorial, consulte Opções de pesquisa vetorial.
Para saber mais sobre pesquisa vetorial, consulte Visão geral da pesquisa vetorial do MongoDB.
Gerenciamento de índices
As seguintes ferramentas permitem gerenciar índices de pesquisa vetorial:
collection-indexes: lista todos os índices em uma coleção, 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 coleção.
Observação
Para atualizar um índice de pesquisa vetorial, descarte o índice existente e crie um novo.
Gerar incorporações automaticamente
O servidor MongoDB MCP oferece suporte a dois mecanismos independentes para gerar incorporações vetoriais:
Geração de incorporação do servidor MCP: o servidor MCP gera incorporações no lado do cliente usando o Voyage AI antes de enviar documentos para o MongoDB. Isso requer uma chave de API Voyage AI.
Incorporação automatizada do MongoDB : o MongoDB gera automaticamente incorporações no lado do servidor quando os documentos são inseridos ou atualizados. Para saber mais, consulte Incorporação automatizada do MongoDB .
Esses mecanismos funcionam de forma independente e podem ser usados juntos ou separadamente, dependendo do seu caso de uso.
Geração de incorporação de servidor MCP
Se você configurar o servidor MCP com uma chave de API do Voyage IA, o servidor poderá gerar automaticamente incorporações das seguintes maneiras:
Gerar incorporações para documentos: incorpora campos de texto em documentos ao usar a ferramenta
insert-many.Gera incorporações para queries: Incorpora a query de pesquisa ao executar consultas de pesquisa vetorial com a ferramenta
aggregate. Especificamente, o servidor gera incorporações para o parâmetroqueryVectorem$vectorSearchqueries de agregação.
O servidor MCP suporta os seguintes modelos de incorporação do Voyage IA:
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 a opção disableEmbeddingsValidation como true. Para saber mais, consulte Opções de pesquisa vetorial.
Incorporação automatizada do MongoDB
Importante
A incorporação automatizada em índices de pesquisa vetorial está disponível como recurso de visualização somente para o MongoDB Community Edition v8.2 e posterior. O recurso e a documentação correspondente podem mudar a qualquer momento durante o período de Pré-visualização.
O MongoDB também pode gerar automaticamente incorporações no lado do servidor quando documentos são inseridos ou atualizados. Essa abordagem não requer uma chave de API do Voyage AI em sua configuração de MCP porque a geração de incorporação ocorre no MongoDB.
O servidor MongoDB MCP oferece suporte ao gerenciamento de índices de pesquisa vetorial com incorporação automatizada, que gera automaticamente incorporações para seus documentos. Você pode criar, descartar e inspecionar índices de pesquisa vetorial com incorporação automatizada por meio de prompts de linguagem natural. A tabela a seguir resume os principais recursos.
Para saber mais,consulte Incorporação automatizada.
Caso de uso | Ferramentas relevantes | Exemplo de prompts |
|---|---|---|
Gerenciar índices | create-indexcollection-indexesdrop-index | "Create an auto embed vector search index on 'plot' field in 'mflix.movies' namespace using voyage-4-large model." |
Inserir dados com incorporações | insert-many` | "Insert these documents with the following fields and automatically generate embeddings..." |
Query com incorporações | aggregate | "Run a vector search query on mflix.movies with the auto embed index on the 'plot' field." |
Considerações
O servidor MongoDB MCP oferece suporte à pré-filtragem de query de pesquisa vetorial. Para saber mais, consulte Pré-filtragem de pesquisa vetorial 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 cluster Atlas, 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 da API Atlas.
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.