|
| 1 | +# MCP Analytics Server — Описание для LobeHub |
| 2 | + |
| 3 | +## Краткое название навыка |
| 4 | +**Аналитика больших данных** |
| 5 | + |
| 6 | +## Полное описание (до 500 символов) |
| 7 | +Профессиональный инструмент для анализа данных любого размера прямо в чате. Загружайте CSV/Parquet файлы из S3, выполняйте SQL-запросы через DuckDB, обрабатывайте данные в Polars/Pandas — всё в изолированном Docker-контейнере. Экономия до 99% токенов на больших файлах. |
| 8 | + |
| 9 | +## Ключевые возможности (5-7 пунктов) |
| 10 | + |
| 11 | +### 🚀 Загрузка файлов из S3/URL |
| 12 | +Загружайте файлы любого размера напрямую из S3 или по ссылке. Один вызов вместо тысяч строк — экономия миллионов токенов. |
| 13 | + |
| 14 | +### 📊 Мульти-движковая аналитика |
| 15 | +- **Polars** — для больших файлов (>100MB), быстрее pandas в 10-50 раз |
| 16 | +- **DuckDB** — для SQL-запросов и кросс-табличного анализа |
| 17 | +- **Pandas** — для совместимости с ML-библиотеками |
| 18 | + |
| 19 | +### 🧠 Умное управление контекстом |
| 20 | +Автоматическая оптимизация для ограничений LobeHub: сжатие, сэмплирование, возврат только нужных результатов. |
| 21 | + |
| 22 | +### 🔒 Безопасность корпоративного уровня |
| 23 | +Каждая сессия в изолированном Docker-контейнере: нет сети, ограничения по памяти/CPU, non-root пользователь, авто-очистка. |
| 24 | + |
| 25 | +### 📈 Профилирование данных |
| 26 | +Мгновенный анализ структуры: типы колонок, статистики, пропуски, рекомендации по оптимизации. |
| 27 | + |
| 28 | +### 🔄 Потоковая обработка |
| 29 | +Работа с файлами >10GB без загрузки в память благодаря lazy evaluation. |
| 30 | + |
| 31 | +## Примеры использования |
| 32 | + |
| 33 | +### Пример 1: Анализ рекламной кампании |
| 34 | +``` |
| 35 | +Пользователь: "Проанализируй эти данные по кампании" |
| 36 | +[Передаётся ссылка на CSV из Lobe Storage] |
| 37 | +
|
| 38 | +AI: Создаю сессию и загружаю файл... |
| 39 | +download_file_from_url(url="...", filename="campaign.csv") |
| 40 | +→ Файл загружен: 150MB (87,291 строк) |
| 41 | +
|
| 42 | +AI: Профилирую данные... |
| 43 | +analytics_profile_dataset("campaign.csv") |
| 44 | +→ 12 колонок, даты с 2025-11-10 по 2026-01-11, ключевые метрики: impressions, conversions |
| 45 | +
|
| 46 | +AI: Топ-5 площадок по конверсии: |
| 47 | +analytics_execute_query(engine="duckdb", query="SELECT publisher, SUM(conversions) FROM campaign.csv GROUP BY publisher ORDER BY 2 DESC LIMIT 5") |
| 48 | +→ Площадка #19: 25,860 конверсий (31% от общих) |
| 49 | +``` |
| 50 | + |
| 51 | +### Пример 2: SQL-анализ продаж |
| 52 | +``` |
| 53 | +Пользователь: "Сравни продажи по кварталам" |
| 54 | +
|
| 55 | +AI: Загружаю данные... |
| 56 | +download_file_from_url(url="...", filename="sales_2024.csv") |
| 57 | +
|
| 58 | +AI: Выполняю SQL-запрос: |
| 59 | +analytics_execute_query( |
| 60 | + engine="duckdb", |
| 61 | + query=""" |
| 62 | + SELECT |
| 63 | + QUARTER(date) as q, |
| 64 | + SUM(revenue) as total, |
| 65 | + AVG(revenue) as avg_order |
| 66 | + FROM sales_2024.csv |
| 67 | + GROUP BY QUARTER(date) |
| 68 | + ORDER BY q |
| 69 | + """ |
| 70 | +) |
| 71 | +→ Q1: $1.2M | Q2: $1.5M | Q3: $1.8M | Q4: $2.1M |
| 72 | +``` |
| 73 | + |
| 74 | +### Пример 3: Обработка большого файла |
| 75 | +``` |
| 76 | +Пользователь: "Есть файл на 2GB с логами, нужна статистика" |
| 77 | +
|
| 78 | +AI: Загружаю файл (2GB = ~50 токенов вместо миллионов)... |
| 79 | +download_file_from_url(url="...", filename="logs.csv") |
| 80 | +
|
| 81 | +AI: Обрабатываю потоково в Polars... |
| 82 | +analytics_execute_query( |
| 83 | + engine="polars", |
| 84 | + query="pl.scan_csv('logs.csv').group_by('level').agg(pl.col('timestamp').count()).sort('timestamp', descending=True)" |
| 85 | +) |
| 86 | +→ INFO: 85% | WARN: 12% | ERROR: 3% |
| 87 | +``` |
| 88 | + |
| 89 | +## Технические детали для LobeHub |
| 90 | + |
| 91 | +### URL подключения |
| 92 | +```json |
| 93 | +{ |
| 94 | + "mcpServers": { |
| 95 | + "analytics": { |
| 96 | + "url": "http://172.17.0.1:8004", |
| 97 | + "type": "http" |
| 98 | + } |
| 99 | + } |
| 100 | +} |
| 101 | +``` |
| 102 | + |
| 103 | +### Требования |
| 104 | +- **Docker** 20.10+ (обязательно) |
| 105 | +- **RAM**: 4GB+ для файлов >1GB |
| 106 | +- **Диск**: 10GB+ для образов и кэша |
| 107 | + |
| 108 | +### Доступные инструменты |
| 109 | +| Инструмент | Назначение | |
| 110 | +|------------|-----------| |
| 111 | +| `create_session` | Создать изолированную сессию | |
| 112 | +| `download_file_from_url` | Загрузить файл из S3/URL | |
| 113 | +| `analytics_profile_dataset` | Профилирование данных | |
| 114 | +| `analytics_execute_query` | SQL/Polars/Pandas запросы | |
| 115 | +| `analytics_stream_sample` | Сэмплирование данных | |
| 116 | +| `execute_code` | Python/JavaScript/TypeScript | |
| 117 | +| `write_file` / `read_file` / `list_files` | Файловые операции | |
| 118 | +| `destroy_session` | Уничтожить сессию | |
| 119 | + |
| 120 | +## Преимущества для пользователей LobeHub |
| 121 | + |
| 122 | +### До (без MCP Analytics) |
| 123 | +- Файл 500KB = ~10,000 токенов → перегрузка контекста |
| 124 | +- Невозможно анализировать файлы >1MB |
| 125 | +- AI тратит токены на хранение данных вместо анализа |
| 126 | + |
| 127 | +### После (с MCP Analytics) |
| 128 | +- Файл 500MB = ~50 токенов (ссылка) + ~200 токенов (результат) |
| 129 | +- Анализ файлов любого размера |
| 130 | +- AI фокусируется на аналитике, а не на хранении данных |
| 131 | + |
| 132 | +## Эмодзи для иконки навыка |
| 133 | +📊 или 🧮 или 📈 |
| 134 | + |
| 135 | +## Теги для поиска |
| 136 | +аналитика, данные, CSV, SQL, pandas, polars, duckdb, большие данные, data science, S3, обработка данных, статистика, визуализация |
| 137 | + |
| 138 | +## Автор |
| 139 | +BDuba |
| 140 | + |
| 141 | +## Лицензия |
| 142 | +MIT |
| 143 | + |
| 144 | +## Ссылка на репозиторий |
| 145 | +https://github.com/BDuba/code-server-mcp |
0 commit comments