Skip to content

Commit cee00c8

Browse files
author
root
committed
docs: add LobeHub skill description
Add comprehensive skill description for LobeHub marketplace including: - Feature highlights and use cases - Technical requirements and setup - Usage examples for different scenarios - Tags and search keywords
1 parent e7077ed commit cee00c8

1 file changed

Lines changed: 145 additions & 0 deletions

File tree

LOBEHUB_SKILL_DESCRIPTION.md

Lines changed: 145 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,145 @@
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

Comments
 (0)