
mcp
florentine-aiMIT
6 звёзд2 форков
MCP-сервер от Florentine.ai подключает AI-ассистента напрямую к MongoDB и MySQL. Вы пишете запрос на русском или английском — сервер сам превращает его в агрегацию MongoDB или SQL-запрос. Разработчик избавляется от ручного написания пайплайнов и сложных JOIN-ов.
Сервер подходит для аналитики, создания внутренних инструментов, техподдержки и любых сценариев, где нужен быстрый доступ к данным через диалог с AI. Для работы понадобится Node.js 18+, бесплатный аккаунт Florentine.ai и хотя бы одна подключенная и активированная коллекция или таблица.
Установка
npx -y @florentine-ai/mcpХарактеристики
Общее
- СтатусСообщество
- Разработчикflorentine-ai
- ЛицензияMIT
Технологии
- ЯзыкиTypeScript
- Транспортstdio
Описание
Возможности
- Преобразует вопросы на русском и английском в агрегации MongoDB и SQL-запросы.
- Автоматически изучает схему базы данных. Передаёт ассистенту структуру коллекций и типы полей.
- Разграничивает данные для разных клиентов (multitenancy). Каждый пользователь видит только свои строки.
- Выполняет семантический векторный поиск (RAG). Эмбеддинги для полей создаются автоматически.
- Исключает из ответов поля с паролями, токенами и другой чувствительной информацией.
- Поддерживает сложные lookup-операции и глубокие вложенные запросы.
- Работает в статическом режиме (параметры в .env) и динамическом (параметры задаются в промпте).
- Сохраняет контекст диалога через session_id. Ассистент помнит историю и может уточнять запросы.
- Возвращает результаты в виде строки, Markdown, JSON-объекта или JSON-массива на выбор.
Как подключить
Установка через npx:
npx -y @florentine-ai/mcp
Добавьте конфигурацию в ваш MCP-клиент. Пример для Claude Desktop (файл claude_desktop_config.json):
{
"mcpServers": {
"florentine": {
"command": "npx",
"args": ["-y", "@florentine-ai/mcp"],
"env": {
"FLORENTINE_API_KEY": "ваш_ключ_из_личного_кабинета",
"MONGODB_URI": "mongodb+srv://user:pass@cluster.mongodb.net",
"DB_NAME": "sales"
}
}
}
}
Перезапустите клиент. Сервер готов к работе.
Важно: предварительно создайте аккаунт на Florentine.ai, подключите базу и активируйте хотя бы одну коллекцию. API-ключ берите из личного кабинета.
Примеры запросов
- «Покажи топ-10 клиентов по сумме покупок за последние 30 дней».
- «Найди все заказы со статусом «доставлен», сгруппируй по менеджеру и выведи итоговую сумму».
- «Есть ли пользователи, которые зарегистрировались, но не сделали ни одного заказа? Выведи их email».
- «Построй сводку продаж по категориям в формате Markdown за 2024 год».
Технические детали
- Язык: TypeScript
- Транспорт: stdio
- Лицензия: MIT
- Зависимости: Node.js >= 18, аккаунт Florentine.ai
- Поддерживаемые базы: MongoDB, MySQL
- Совместимость: Claude Desktop, Continue.dev, Cursor, любой MCP-клиент