mcp

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-клиент

Поделиться