🗄️ Сервер Mongodb Mcp для Llms

Что такое mongo-mcp?

mongo-mcp — это реализация сервера MongoDB, разработанная для Протокола Модельного Контекста (MCP). Этот проект направлен на предоставление надежного и эффективного способа управления и взаимодействия с базами данных MongoDB, облегчая бесшовную интеграцию с приложениями, использующими фреймворк MCP. Используя возможности MongoDB, mongo-mcp позволяет разработчикам создавать масштабируемые и высокопроизводительные приложения.

Особенности mongo-mcp

• Совместимость с MCP: mongo-mcp специально разработан для работы с Протоколом Модельного Контекста, что гарантирует соответствие требованиям приложений, построенных на этом протоколе.
• Масштабируемость: Основанный на MongoDB, mongo-mcp может обрабатывать большие объемы данных и множество одновременных подключений, что делает его подходящим для приложений уровня предприятия.
• Удобство использования: Сервер разработан с учетом удобства пользователя, предоставляя простой процесс установки и настройки.
• Открытый исходный код: Будучи публичным репозиторием, mongo-mcp открыт для вкладов, позволяя разработчикам сотрудничать и улучшать проект.
• Активное сообщество: Проект привлек внимание и вклады от растущего сообщества разработчиков, что обеспечивает постоянное улучшение и поддержку.

Как использовать mongo-mcp

1. Установка: Начните с клонирования репозитория с GitHub:

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

2. Конфигурация: Перейдите в каталог проекта и настройте параметры сервера в соответствии с вашими требованиями. Это может включать настройку подключений к базе данных и определение протоколов.
3. Запуск сервера: Используйте предоставленные скрипты или команды для запуска сервера mongo-mcp. Убедитесь, что MongoDB установлена и запущена на вашем компьютере.
4. Интеграция: Подключите ваши приложения к серверу mongo-mcp, используя фреймворк MCP, что позволит эффективно управлять данными и извлекать их.

Часто задаваемые вопросы

Что такое Протокол Модельного Контекста (MCP)?

Протокол Модельного Контекста (MCP) — это фреймворк, который определяет, как приложения могут взаимодействовать с моделями данных структурированным образом. Он предоставляет рекомендации по манипуляции данными, обеспечивая согласованность и надежность между различными приложениями.

Подходит ли mongo-mcp для использования в производственной среде?

Да, mongo-mcp разработан как надежный и масштабируемый, что делает его подходящим для производственных сред. Однако рекомендуется тщательно протестировать сервер в вашем конкретном случае использования перед развертыванием в рабочей среде.

Как я могу внести вклад в проект mongo-mcp?

Вклады приветствуются! Вы можете внести вклад, сообщая о проблемах, отправляя запросы на слияние или улучшая документацию. Пожалуйста, обратитесь к странице проекта на GitHub для получения рекомендаций по вкладу.

Где я могу найти больше информации о mongo-mcp?

Для получения более подробной информации, документации и обновлений посетите репозиторий mongo-mcp на 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.