MongoDB MCP Server FERRAMENTAS

O Servidor MongoDB MCP permite que você interaja com clusters MongoDB usando queries de linguagem natural de clientes de IA que suportam 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 agregação pipelines.

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
`atlas-list-orgs`	Retorna uma lista de organizações do Atlas .
`atlas-list-projects`	Retorna uma lista de projetos do Atlas .
`atlas-create-project`	Cria um novo projeto Atlas .
`atlas-list-clusters`	Retorna a lista de Atlas clusters.
`atlas-inspect-cluster`	Retorna informações sobre um Atlas cluster específico.
`atlas-create-free-cluster`	Cria um Atlas cluster gratuito.
`atlas-connect-cluster`	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.
`atlas-inspect-access-list`	Retorna informações sobre os intervalos IP e CIDR que podem acessar um cluster do Atlas .
`atlas-create-access-list`	Configura a lista de acesso IP e CIDR para um cluster Atlas.
`atlas-list-db-users`	Retorna uma lista de usuários do banco de dados do Atlas .
`atlas-create-db-user`	Cria um usuário de banco de dados Atlas .
`atlas-list-alerts`	Retorna uma lista de alertas para um projeto Atlas .
`atlas-get-performance-advisor`	Retorna recomendações do Performance Advisor para um cluster Atlas . Oferece suporte a operações para índices sugeridos, sugestões de índice suspenso, registros de queries lentas e sugestões de esquema. Requer acesso ou `Project Read Only` superior. Para saber mais,consulte a ferramenta Performance Advisor.

Atlas locais do servidor MCP

Você pode utilizar o servidor MCP com sistemas locais do Atlas . Para usar as ferramentas do Servidor MCP com sistemas locais do Atlas , você deve instalar o Docker. Para uma introdução aos sistemas locais do Atlas , consulte Criar um sistema local do Atlas .

A tabela seguinte descreve as ferramentas Atlas locais:

Nome da ferramenta Atlas local do servidor MCP	Descrição
`atlas-local-list-deployments`	Lista sistemas locais do Atlas .
`atlas-local-create-deployment`	Cria um sistema local do Atlas . Para executar esta ferramenta, você deve desativar o modo somente leitura.
`atlas-local-connect-deployment`	Conecta a um sistema local do Atlas .
`atlas-local-delete-deployment`	Exclui um sistema local do Atlas . Para executar esta ferramenta, você deve desativar o modo somente leitura.

Para exemplos que executam as ferramentas locais do Atlas , consulte Sistemas 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
`connect`	Conecta-se a um cluster.
`find`	Executa uma query de banco de dados .
`aggregate`	Executa um agregação pipeline.
`count`	Retorna o número de documentos em uma coleção.
`insert-one`	Adiciona um único documento a uma collection.
`insert-many`	Adiciona vários documentos a uma collection.
`create-index`	Adiciona um índice a uma collection.
`update-one`	Modifica um único documento em uma coleção.
`update-many`	Modifica vários documentos em uma coleção.
`rename-collection`	Altera o nome de uma coleção.
`delete-one`	Remove um único documento de uma coleção.
`delete-many`	Remove vários documentos de uma collection.
`drop-collection`	Exclui uma collection de um banco de dados.
`drop-database`	Exclui um banco de dados.
`list-databases`	Retorna uma lista de todos os bancos de dados disponíveis através da conexão atual.
`list-collections`	Retorna uma lista de collections em um banco de dados.
`collection-indexes`	Retorna informações sobre índices de coleção.
`collection-schema`	Retorna informações do esquema de collection.
`collection-storage-size`	Retorna o tamanho da coleção em megabytes.
`db-stats`	Retorna estatísticas do banco de dados .
`export`	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 `exported-data` no aplicação cliente de IA.

Detalhes da ferramenta

Para obter informações adicionais sobre ferramentas específicas de MCP, consulte as seções a seguir.

Conectando sem Atlas Connection String

Se você configurou o servidor MCP sem especificar uma string de conexão para um Atlas cluster, a ferramenta atlas-connect-cluster 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:
- readAnyDatabase se você ativou o modo somente leitura ou desativou as categorias de ferramentas create, delete e update.
- readWriteAnyDatabase se o servidor tiver permissões completas.

Observação

As credenciais do usuário são armazenadas somente na memória do servidor do MCP e nunca são devolvidas ou expostas no contexto do LLM.

Ferramenta de Performance Advisor

A atlas-get-performance-advisor ferramenta permite acessar as recomendações do Performance Advisor por meio de queries 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 acesso ou superior e Project Read Only um10cluster M +. Ele está disponível com a --readonly bandeira.

Caso de uso	Exemplo de prompts	Operação do Performance Advisor
Analisar queries lentas	`Show me my slow queries` `What is slowing down my cluster?` `Show me queries that are longer than 5 seconds` `Show me slow writes in the website.users namespace`	slowQueryLogs
Sugestões de Índices	`Are there any indexes I should create to improve performance?` `What indexes do you recommend I drop?`	índices sugeridos dropIndexSuggestions
Conselho sobre o esquema	`Show schema recommendations for my cluster` `Help me optimize my database schema`	schemaAdvice

Para obter exemplos de uso detalhados e amostras de saída, consulte Otimização de desempenho.

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.

Voltar

Solução de problemas

Segurança