mcp-mongo-server
by kiliczsh (community) Claude Desktop, Claude Code, MongoDB
Community MCP-сервер для работы с MongoDB. Позволяет LLM читать коллекции, выполнять запросы и исследовать структуру документов прямо в чате. Возможности: - Подключение к MongoDB (local или Atlas) по URI - Список баз данных и коллекций - `find` с фильтрами, проекцией, limit/skip - `aggregate` — MongoDB aggregation pipeline - Просмотр схемы (sample documents для вывода структуры) - Только чтение по умолчанию (безопасный режим)
# Claude Desktop — claude_desktop_config.json:
{
"mcpServers": {
"mongodb": {
"command": "npx",
"args": ["-y", "mcp-mongo-server", "mongodb://localhost:27017/mydb"]
}
}
}
# Claude Code (CLI):
claude mcp add mongodb -- npx -y mcp-mongo-server mongodb://localhost:27017/mydb
# OpenCode — ~/.config/opencode/opencode.json:
{
"mcp": {
"mongodb": {
"type": "local",
"command": ["npx", "-y", "mcp-mongo-server", "mongodb://localhost:27017/mydb"]
}
}
}
MCP MongoDB Server
Сервер Model Context Protocol, который позволяет LLM взаимодействовать с базами данных MongoDB. Этот сервер предоставляет возможности для просмотра схем коллекций и выполнения операций MongoDB через стандартизированный интерфейс.
Демо
Основные возможности
- Умная обработка ObjectId — Настраиваемые режимы авто/отключено/принудительно для преобразования строк в ObjectId
- Режим только для чтения — Защита от операций записи, использует вторичный приоритет чтения
- Вывод схемы — Автоматическое определение схемы коллекции на основе выборок документов
- Запросы и агрегация — Полная поддержка запросов и конвейеров агрегации MongoDB с необязательными планами explain
- Операции записи — Вставка, обновление и создание индексов (когда не в режиме только для чтения)
- Автодополнение коллекций — Автодополнение имён коллекций для интеграции с LLM
Установка
npx -y mcp-mongo-server mongodb://localhost:27017/database
Использование
# Запуск сервера с URI MongoDB
npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database
# Подключение в режиме только для чтения
npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database --read-only
Переменные окружения
| Переменная | Описание |
|---|---|
MCP_MONGODB_URI |
URI подключения к MongoDB |
MCP_MONGODB_READONLY |
Включить режим только для чтения ("true") |
Документация
- Руководство по интеграции — Claude Desktop, Windsurf, Cursor, Docker
- Доступные инструменты — Запросы, агрегация, обновление, вставка и многое другое
- Разработка — Настройка, скрипты и отладка
- Участие в проекте
Лицензия
MIT — см. LICENSE для подробностей.