Skip to main content
Glama
Sign In
deenesjakoruzh

MongoDB

by kiliczsh
npmGitHub
TypeScript
MIT License
885
191
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides access to MongoDB databases, allowing LLMs to inspect collection schemas and execute MongoDB operations like queries, aggregations, updates, inserts, and creating indexes

MCP-сервер MongoDB

Сервер Model Context Protocol, который позволяет LLM взаимодействовать с базами данных MongoDB. Этот сервер предоставляет возможности для проверки схем коллекций и выполнения операций MongoDB через стандартизированный интерфейс.

Демо

Основные характеристики

Интеллектуальная обработка ObjectId

  • Интеллектуальное преобразование между строковыми идентификаторами и MongoDB ObjectId
  • Настраивается с помощью параметра objectIdMode :
    • "auto" : Преобразование на основе имен полей (по умолчанию)
    • "none" : нет преобразования
    • "force" : принудительно установить все поля идентификатора строки в ObjectId

Гибкая конфигурация

  • Переменные среды :
    • MCP_MONGODB_URI : URI соединения MongoDB
    • MCP_MONGODB_READONLY : включить режим «только чтение», если установлено значение «true»
  • Параметры командной строки :
    • --read-only или -r : Подключиться в режиме только для чтения

Режим «Только чтение»

  • Защита от операций записи (обновление, вставка, создание индекса)
  • Использует вторичный приоритет чтения MongoDB для оптимальной производительности
  • Идеально подходит для безопасного подключения к производственным базам данных

Операции MongoDB

  • Операции чтения :
    • Запрос документов с дополнительным анализом плана выполнения
    • Выполнение агрегационных конвейеров
    • Количество документов, соответствующих критериям
    • Получить информацию о схеме сбора
  • Операции записи (не в режиме только для чтения):
    • Обновление документов
    • Вставить новые документы
    • Создать индексы

Интеграция LLM

  • Завершения коллекции для улучшенного взаимодействия LLM
  • Вывод схемы для лучшего понимания контекста
  • Анализ сбора данных для понимания сути данных

Установка

Глобальная установка

npm install -g mcp-mongo-server

Для развития

# Clone repository git clone https://github.com/kiliczsh/mcp-mongo-server.git cd mcp-mongo-server # Install dependencies npm install # Build npm run build # Development with auto-rebuild npm run watch

Использование

Базовое использование

# Start server with MongoDB URI npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database # Connect in read-only mode npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database --read-only

Переменные среды

Вы можете настроить сервер с помощью переменных среды, что особенно полезно для конвейеров CI/CD, контейнеров Docker или в тех случаях, когда вы не хотите раскрывать сведения о подключении в аргументах команды:

# Set MongoDB connection URI export MCP_MONGODB_URI="mongodb://muhammed:kilic@localhost:27017/database" # Enable read-only mode export MCP_MONGODB_READONLY="true" # Run server (will use environment variables if no URI is provided) npx -y mcp-mongo-server

Использование переменных среды в конфигурации Claude Desktop:

{ "mcpServers": { "mongodb-env": { "command": "npx", "args": [ "-y", "mcp-mongo-server" ], "env": { "MCP_MONGODB_URI": "mongodb://muhammed:kilic@localhost:27017/database", "MCP_MONGODB_READONLY": "true" } } } }

Использование переменных среды с Docker:

# Build docker build -t mcp-mongo-server . # Run docker run -it -d -e MCP_MONGODB_URI="mongodb://muhammed:kilic@localhost:27017/database" -e MCP_MONGODB_READONLY="true" mcp-mongo-server # or edit docker-compose.yml and run docker-compose up -d

Интеграция с Claude Desktop

Ручная настройка

Добавьте конфигурацию сервера в файл конфигурации Claude Desktop:

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

Подход с аргументами командной строки:
{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mcp-mongo-server", "mongodb://muhammed:kilic@localhost:27017/database" ] }, "mongodb-readonly": { "command": "npx", "args": [ "-y", "mcp-mongo-server", "mongodb://muhammed:kilic@localhost:27017/database", "--read-only" ] } } }
Подход с использованием переменных среды:
{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mcp-mongo-server" ], "env": { "MCP_MONGODB_URI": "mongodb://muhammed:kilic@localhost:27017/database" } }, "mongodb-readonly": { "command": "npx", "args": [ "-y", "mcp-mongo-server" ], "env": { "MCP_MONGODB_URI": "mongodb://muhammed:kilic@localhost:27017/database", "MCP_MONGODB_READONLY": "true" } } } }

Использование пакета GitHub:

{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "github:kiliczsh/mcp-mongo-server", "mongodb://muhammed:kilic@localhost:27017/database" ] }, "mongodb-readonly": { "command": "npx", "args": [ "-y", "github:kiliczsh/mcp-mongo-server", "mongodb://muhammed:kilic@localhost:27017/database", "--read-only" ] } } }

Интеграция с Windsurf и Cursor

Сервер MCP MongoDB можно использовать с Windsurf и Cursor аналогично Claude Desktop.

Конфигурация виндсерфинга

Добавьте сервер в конфигурацию Windsurf:

{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mcp-mongo-server", "mongodb://muhammed:kilic@localhost:27017/database" ] } } }

Конфигурация курсора

Для курсора добавьте конфигурацию сервера в свои настройки:

{ "mcpServers": { "mongodb": { "command": "npx", "args": [ "-y", "mcp-mongo-server", "mongodb://muhammed:kilic@localhost:27017/database" ] } } }

Вы также можете использовать подход с переменными среды как с Windsurf, так и с Cursor, следуя той же схеме, которая показана в конфигурации Claude Desktop.

Автоматическая установка

Использование кузнечного дела :

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

Использование mcp-get :

npx @michaellatman/mcp-get@latest install mcp-mongo-server

Доступные инструменты

Операции запроса

  • запрос : выполнение запросов MongoDB
    { collection: "users", filter: { age: { $gt: 30 } }, projection: { name: 1, email: 1 }, limit: 20, explain: "executionStats" // Optional }
  • агрегат : запуск конвейеров агрегации
    { collection: "orders", pipeline: [ { $match: { status: "completed" } }, { $group: { _id: "$customerId", total: { $sum: "$amount" } } } ], explain: "queryPlanner" // Optional }
  • count : Количество соответствующих документов
    { collection: "products", query: { category: "electronics" } }

Операции записи

  • обновление : Изменить документы
    { collection: "posts", filter: { _id: "60d21b4667d0d8992e610c85" }, update: { $set: { title: "Updated Title" } }, upsert: false, multi: false }
  • вставить : Добавить новые документы
    { collection: "comments", documents: [ { author: "user123", text: "Great post!" }, { author: "user456", text: "Thanks for sharing" } ] }
  • createIndex : Создание индексов коллекций
    { collection: "users", indexes: [ { key: { email: 1 }, unique: true, name: "email_unique_idx" } ] }

Системные операции

  • serverInfo : Получить сведения о сервере MongoDB
    { includeDebugInfo: true // Optional }

Отладка

Поскольку серверы MCP взаимодействуют через stdio, отладка может быть сложной. Используйте MCP Inspector для лучшей видимости:

npm run inspector

Это предоставит URL-адрес для доступа к инструментам отладки в вашем браузере.

Запуск оценок

Пакет evals загружает клиент mcp, который затем запускает файл index.ts, поэтому нет необходимости перестраиваться между тестами. Вы можете загрузить переменные среды, указав префикс команды npx. Полную документацию можно найти здесь .

OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/schemas/tools.ts

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Сервер Model Context Protocol, который позволяет LLM взаимодействовать с базами данных MongoDB. Этот сервер предоставляет возможности для проверки схем коллекций и выполнения операций MongoDB через стандартизированный интерфейс.

  1. Демо
    1. Основные характеристики
      1. Интеллектуальная обработка ObjectId
      2. Гибкая конфигурация
      3. Режим «Только чтение»
      4. Операции MongoDB
      5. Интеграция LLM
    2. Установка
      1. Глобальная установка
      2. Для развития
    3. Использование
      1. Базовое использование
      2. Переменные среды
    4. Интеграция с Claude Desktop
      1. Ручная настройка
      2. Использование пакета GitHub:
    5. Интеграция с Windsurf и Cursor
      1. Конфигурация виндсерфинга
      2. Конфигурация курсора
      3. Автоматическая установка
    6. Доступные инструменты
      1. Операции запроса
      2. Операции записи
      3. Системные операции
    7. Отладка
      1. Запуск оценок
        1. Лицензия

          Related MCP Servers

          • MongoDB

            QuantGeekDev
            -
            security
            A
            license
            -
            quality
            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.
            Last updated -
            340
            75
            TypeScript
            MIT License
            • Apple

          • MongoDB MCP Server

            jonfreeland
            A
            security
            A
            license
            A
            quality
            A Model Context Protocol server that provides read-only access to MongoDB databases, enabling AI assistants to directly query and analyze MongoDB data while maintaining data safety.
            Last updated -
            14
            9
            2
            JavaScript
            MIT License
            • Apple

          • MongoDB MCP Server for LLMs

            nickiiitu
            -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that enables LLMs to interact directly with MongoDB databases, allowing users to query collections, inspect schemas, and manage data through natural language.
            Last updated -
            340
            TypeScript
            MIT License
            • Apple

          • MongoDB MCP Server for LLMs

            vivek1612
            -
            security
            A
            license
            -
            quality
            A Model Context Protocol server that enables LLMs to interact directly with MongoDB databases, allowing users to query collections, inspect schemas, and manage data through natural language.
            Last updated -
            340
            MIT License
            • Apple

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          ID: zc7f7d53hc