MongoDB

Interaja com bancos de dados MongoDB usando linguagem natural para consultar coleções, inspecionar esquemas e gerenciar dados.

GitHub
2
Experimente este MCPPatrocinado

Documentação

🗄️ Servidor MCP MongoDB para LLMS

Node.js 18+ License: MIT smithery badge

Um servidor Model Context Protocol (MCP) que permite que LLMs interajam diretamente com bancos de dados MongoDB. Consulte coleções, inspecione esquemas e gerencie dados de forma integrada por meio de linguagem natural.

✨ Recursos

  • 🔍 Inspeção de esquema de coleções
  • 📊 Consulta e filtragem de documentos
  • 📈 Gerenciamento de índices
  • 📝 Operações de documentos (inserir, atualizar, excluir)

🚀 Início Rápido

Para começar, encontre sua URL de conexão do MongoDB e adicione esta configuração ao seu arquivo de configuração do Claude Desktop:

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "mongo-mcp",
        "mongodb://<username>:<password>@<host>:<port>/<database>?authSource=admin"
      ]
    }
  }
}

Pré-requisitos

  • Node.js 18+
  • npx
  • Docker e Docker Compose (apenas para testes locais em sandbox)
  • Cliente MCP (por exemplo, o aplicativo Claude Desktop)

Configuração do Sandbox de Teste

Se você não tiver um servidor MongoDB para se conectar e quiser criar um sandbox de exemplo, siga estas etapas:

  1. Inicie o MongoDB usando o Docker Compose:
docker-compose up -d
  1. Popule o banco de dados com dados de teste:
npm run seed

Configurar o Claude Desktop

Adicione esta configuração ao seu arquivo de configuração do Claude Desktop:

MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Modo de Desenvolvimento Local:

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": [
        "dist/index.js",
        "mongodb://root:example@localhost:27017/test?authSource=admin"
      ]
    }
  }
}

Estrutura de Dados do Sandbox de Teste

O script de seed cria três coleções com dados de exemplo:

Usuários

  • Informações pessoais (nome, e-mail, idade)
  • Endereço aninhado com coordenadas
  • Matrizes de interesses
  • Datas de associação

Produtos

  • Detalhes do produto (nome, SKU, categoria)
  • Especificações aninhadas
  • Informações de preço e estoque
  • Tags e avaliações

Pedidos

  • Detalhes do pedido com itens
  • Referências de usuário
  • Informações de envio e pagamento
  • Acompanhamento de status

🎯 Exemplos de Prompts

Experimente estes prompts com o Claude para explorar a funcionalidade:

Operações Básicas

"What collections are available in the database?"
"Show me the schema for the users collection"
"Find all users in San Francisco"

Consultas Avançadas

"Find all electronics products that are in stock and cost less than $1000"
"Show me all orders from the user john@example.com"
"List the products with ratings above 4.5"

Gerenciamento de Índices

"What indexes exist on the users collection?"
"Create an index on the products collection for the 'category' field"
"List all indexes across all collections"

Operações de Documentos

"Insert a new product with name 'Gaming Laptop' in the products collection"
"Update the status of order with ID X to 'shipped'"
"Find and delete all products that are out of stock"

📝 Ferramentas Disponíveis

O servidor fornece estas ferramentas para interação com o banco de dados:

Ferramentas de Consulta

  • find: Consulta documentos com filtragem e projeção
  • listCollections: Lista as coleções disponíveis
  • insertOne: Insere um único documento
  • updateOne: Atualiza um único documento
  • deleteOne: Exclui um único documento

Ferramentas de Índice

  • createIndex: Cria um novo índice
  • dropIndex: Remove um índice
  • indexes: Lista os índices de uma coleção

Certificado por:-

📜 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

MongoDB-Model-Context-Protocol-MCP-