MongoDB MCP-сервер
Мощная реализация сервера Model Context Protocol (MCP), обеспечивающая бесперебойное взаимодействие с базами данных MongoDB по стандартизированному протоколу.
Автор
Расталион
контур
Данная реализация сервера MCP предоставляет мощный интерфейс для взаимодействия с базой данных MongoDB через протокол контекста модели. Он обеспечивает надежную поддержку операций с базами данных, коллекциями и документами с помощью шаблона async/await и обработки ошибок.
характеристика
- Полная поддержка операций MongoDB CRUD
- Обработка безопасных подключений к MongoDB
- Шаблон async/await для оптимальной производительности
- Комплексная обработка ошибок
- Поддержка Docker для простого развертывания
- Выполнение запросов с подсказками типов
- Поддержка событий, отправленных сервером (SSE), для обновлений в реальном времени
Быстрый старт
Использовать как CLI-инструмент
Запустить через UVX
Запустить Python напрямую
Использование Докера
Использование UVX
UVX — это инструмент, позволяющий легко управлять сервисами в различных средах.
Более подробную информацию см. в руководстве UVX .
Переменные среды
Перед запуском сервера установите следующие переменные среды:
конечная точка API
- Проверить здоровье :
GET /health
- MCP API :
GET /mcp
— конечная точка FastMCP (документация OpenAPI) - SSE-соединение :
GET /sse
— конечная точка событий, отправленных сервером - Обработка сообщений :
POST /messages
— конечная точка обработки сообщений
Интеграция с IDE
Настройки VS-кода
Добавьте следующее в файл settings.json VS Code:
Клод или другой помощник с искусственным интеллектом
Настройте свой MCP-сервер для Клода или других помощников на основе искусственного интеллекта следующим образом:
Доступные инструменты
Название инструмента | объяснение |
---|---|
listCollections | Список всех доступных коллекций в базе данных |
find | Извлечение документов из коллекции с использованием синтаксиса запросов MongoDB |
insertOne | Вставить один документ в коллекцию |
updateOne | Обновить отдельный документ в коллекции |
deleteOne | Удалить один документ из коллекции |
indexes | Список всех индексов в коллекции |
createIndex | Создать новый индекс в коллекции |
dropIndex | Удалить существующий индекс из коллекции |
Расширенное использование
Добавить пользовательские инструменты
- Создайте новый инструмент в
app/tools/documents/
илиapp/tools/collection/
:
- Зарегистрируйте инструмент в
app/tools/registry.py
:
Установка и развертывание инструментов CLI
Вы можете сделать его доступным по всему миру, зарегистрировав его как пакет на PyPI:
Поиск неисправностей
- Если сервер не запускается : Проверьте справку по
mongo-mcp-server --help
- Проблема с подключением MongoDB : проверьте правильность параметра
--mongodb-url
- Ошибка выполнения инструмента : проверьте реализацию инструмента и входные параметры.
- Проблема с Docker : проверьте логи с помощью
docker-compose logs mongo-mcp
Конфигурация докера
Конфигурация Docker включает в себя:
- Базовый образ Python 3.12
- Часовой пояс Азия/Сеул
- Экземпляр MongoDB 4.4
- Постоянные тома для хранения базы данных
- Проверка работоспособности обеих служб
- Автоматическая настройка сети
Лицензия
Данный проект распространяется по лицензии MIT — подробности см. в файле LICENSE .
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Мощная реализация сервера Model Context Protocol (MCP), которая обеспечивает стандартизированное взаимодействие с базами данных MongoDB, поддерживая полные операции CRUD, асинхронные шаблоны и обновления в реальном времени через SSE.
Related MCP Servers
- -securityAlicense-qualityA 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 -34075TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that provides access to MongoDB databases. This server enables LLMs to inspect collection schemas and execute read-only queries.Last updated -8817217TypeScriptMIT License
- AsecurityAlicenseAqualityA 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 -1492JavaScriptMIT License
- -securityAlicense-qualityA Model Context Protocol (MCP) implementation for connecting to and working with various database systems.Last updated -2317TypeScriptMIT License