🗄️ Servidor Mongodb Mcp Para Llms

O que é mongo-mcp?

mongo-mcp é uma implementação de servidor MongoDB projetada para o Protocolo de Contexto de Modelo (MCP). Este projeto tem como objetivo fornecer uma maneira robusta e eficiente de gerenciar e interagir com bancos de dados MongoDB, facilitando a integração perfeita com aplicações que utilizam a estrutura MCP. Ao aproveitar as capacidades do MongoDB, mongo-mcp permite que os desenvolvedores construam aplicações escaláveis e de alto desempenho.

Recursos do mongo-mcp

• Compatibilidade com MCP: mongo-mcp é especificamente projetado para funcionar com o Protocolo de Contexto de Modelo, garantindo que atenda aos requisitos de aplicações construídas com esse protocolo.
• Escalabilidade: Construído sobre o MongoDB, mongo-mcp pode lidar com grandes volumes de dados e numerosas conexões simultâneas, tornando-o adequado para aplicações de nível empresarial.
• Facilidade de Uso: O servidor é projetado com a facilidade de uso em mente, proporcionando um processo de configuração e instalação simples.
• Código Aberto: Sendo um repositório público, mongo-mcp está aberto a contribuições, permitindo que desenvolvedores colaborem e aprimorem o projeto.
• Comunidade Ativa: O projeto atraiu a atenção e contribuições de uma comunidade crescente de desenvolvedores, garantindo melhoria contínua e suporte.

Como Usar mongo-mcp

1. Instalação: Comece clonando o repositório do GitHub:

   git clone https://github.com/QuantGeekDev/mongo-mcp.git
   

2. Configuração: Navegue até o diretório do projeto e configure as definições do servidor de acordo com suas necessidades. Isso pode incluir a configuração de conexões de banco de dados e definição de protocolos.
3. Executando o Servidor: Use os scripts ou comandos fornecidos para iniciar o servidor mongo-mcp. Certifique-se de que o MongoDB esteja instalado e em execução em sua máquina.
4. Integração: Conecte suas aplicações ao servidor mongo-mcp usando a estrutura MCP, permitindo uma gestão e recuperação de dados eficientes.

Perguntas Frequentes

O que é o Protocolo de Contexto de Modelo (MCP)?

O Protocolo de Contexto de Modelo (MCP) é uma estrutura que define como as aplicações podem interagir com modelos de dados de maneira estruturada. Ele fornece diretrizes para manipulação de dados, garantindo consistência e confiabilidade entre diferentes aplicações.

O mongo-mcp é adequado para uso em produção?

Sim, o mongo-mcp é projetado para ser robusto e escalável, tornando-o adequado para ambientes de produção. No entanto, é recomendável testar minuciosamente o servidor em seu caso de uso específico antes de implantá-lo em um ambiente ao vivo.

Como posso contribuir para o projeto mongo-mcp?

Contribuições são bem-vindas! Você pode contribuir relatando problemas, enviando pull requests ou melhorando a documentação. Consulte a página do projeto no GitHub para diretrizes de contribuição.

Onde posso encontrar mais informações sobre mongo-mcp?

Para informações mais detalhadas, documentação e atualizações, visite o repositório do mongo-mcp no GitHub.

🗄️ MongoDB MCP Server for LLMS

A Model Context Protocol (MCP) server that enables LLMs to interact directly with MongoDB databases. Query collections, inspect schemas, and manage data seamlessly through natural language.

✨ Features

• 🔍 Collection schema inspection
• 📊 Document querying and filtering
• 📈 Index management
• 📝 Document operations (insert, update, delete)

Demo Video

https://github.com/user-attachments/assets/2389bf23-a10d-49f9-bca9-2b39a1ebe654

🚀 Quick Start

To get started, find your mongodb connection url and add this configuration to your Claude Desktop config file:

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"
      ]
    }
  }
}

Installing via Smithery

To install MongoDB MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mongo-mcp --client claude

Prerequisites

• Node.js 18+
• npx
• Docker and Docker Compose (for local sandbox testing only)
• MCP Client (Claude Desktop App for example)

Test Sandbox Setup

If you don't have a mongo db server to connect to and want to create a sample sandbox, follow these steps

1. Start MongoDB using Docker Compose:

docker-compose up -d

2. Seed the database with test data:

npm run seed

Configure Claude Desktop

Add this configuration to your Claude Desktop config file:

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

Local Development Mode:

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

Test Sandbox Data Structure

The seed script creates three collections with sample data:

Users

• Personal info (name, email, age)
• Nested address with coordinates
• Arrays of interests
• Membership dates

Products

• Product details (name, SKU, category)
• Nested specifications
• Price and inventory info
• Tags and ratings

Orders

• Order details with items
• User references
• Shipping and payment info
• Status tracking

🎯 Example Prompts

Try these prompts with Claude to explore the functionality:

Basic Operations

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

Advanced Queries

"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"

Index Management

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

Document Operations

"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"

📝 Available Tools

The server provides these tools for database interaction:

Query Tools

• find: Query documents with filtering and projection
• listCollections: List available collections
• insertOne: Insert a single document
• updateOne: Update a single document
• deleteOne: Delete a single document

Index Tools

• createIndex: Create a new index
• dropIndex: Remove an index
• indexes: List indexes for a collection

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.