GreptimeDB MCP Server
Агент запрашивает метрики, логи и трассы из GreptimeDB на SQL, TQL и RANGE, с запретом записи и маскировкой чувствительных данных
- 29 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент читает метрики и логи, в которых бывают чувствительные значения, маскирование покрывает не все случаи
- Флаг записи открывает DDL и изменение конвейеров и дашбордов, на боевых данных его включать не стоит
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/greptimedb-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает метрики и логи, в которых бывают чувствительные значения, маскирование покрывает не все случаи
- Флаг записи открывает DDL и изменение конвейеров и дашбордов, на боевых данных его включать не стоит
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Официальный MCP-сервер команды GreptimeDB, базы данных наблюдаемости, которая хранит метрики, логи и трассы в одном движке. Агент отправляет запросы на SQL, TQL (совместим с PromQL) и RANGE и получает ответ в CSV, JSON или Markdown. Инструменты разбиты на три группы. Запросы: execute_sql, execute_tql, query_range, explain_query, describe_table, а также поиск таблиц по смыслу и запрос графа сущностей. Конвейеры обработки логов: создание, пробный прогон и удаление. Дашборды Perses: список, создание и удаление. Есть подсказки для типовых задач, от PromQL-анализа до проектирования схемы. По умолчанию сервер только читает. Включить запись можно флагом, но авторы помечают это как опасное и годное только для локальных тестов. Размер ответа ограничен одним мегабайтом, чувствительные значения маскируются, аудит включен.
Для кого. Инженерам SRE и бэкенда, у которых метрики и логи лежат в GreptimeDB и разбирать их удобнее вопросами к агенту.
Подходит, если
- После инцидента надо сопоставить скачок задержки с логами и трассами за то же окно
- Нужен PromQL-запрос, а синтаксис TQL надо вспоминать
- Медленный запрос нужно разобрать по плану выполнения
- Таблицы незнакомы, и агенту надо найти нужные по смыслу метрики
- Надо набросать конвейер разбора логов и прогнать его на пробных данных
Не подходит, если
- Данные лежат в другой базе: сервер работает только с GreptimeDB
- Нужно развернуть сам GreptimeDB или настроить его: инструменты только запрашивают и ведут конвейеры с дашбордами
- Нужна запись данных в боевую базу: этот режим авторы допускают только для локальных тестов
- Нужен вывод больше мегабайта за раз: ответ обрезается
Пример запроса к агенту
Покажи 95-й процентиль задержки по сервисам за последний час и найди в логах ошибки в тот же период.MCP
- Транспорт
- stdio, http, sse
- Авторизация
- ключ необязателен
Переменные окружения
GREPTIMEDB_HOSTобязательная- Адрес базы GreptimeDB
GREPTIMEDB_PASSWORDсекрет- Пароль пользователя базы
GREPTIMEDB_ALLOW_WRITE- Разрешить запись, по умолчанию выключено
Ограничения
Запрос к графу сущностей требует GreptimeDB 1.3, при старте сервер проверяет нужные представления. Подключение идет по протоколу MySQL, порт по умолчанию 4002.
Режим только чтения включен по умолчанию, и менять его на боевых данных не стоит. Чтение выходит за пределы выбранной базы: при доступе у аккаунта можно обращаться к таблицам других баз.
Защита от подмены DNS по умолчанию выключена ради совместимости с прокси, ее включают списком разрешенных хостов.
Как отключить. Удалите запись greptimedb из конфигурации клиента, для Claude Code это claude mcp remove greptimedb. Пароль базы смените, если он лежал в конфиге.
Частые вопросы
Как запустить сервер GreptimeDB для Claude?
Установите пакет командой pip install greptimedb-mcp-server и запустите greptimedb-mcp-server --host localhost --database public. Для Claude Desktop ту же команду пропишите в claude_desktop_config.json.
Может ли агент изменить данные?
По умолчанию нет, режим только чтения включен. Запись, DDL и правки конвейеров открывает переменная GREPTIMEDB_ALLOW_WRITE, авторы называют ее опасной.
Что такое TQL?
Язык запросов GreptimeDB, совместимый с PromQL. Сервер выполняет его инструментом execute_tql.
Как скрыть чувствительные данные?
Маскирование включено по умолчанию, дополнительные шаблоны задаются в GREPTIMEDB_MASK_PATTERNS через запятую.
Работает ли сервер по сети?
Да, кроме stdio есть режимы streamable-http и sse для контейнеров и Kubernetes. Порт и адрес прослушивания задают переменные окружения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОдин MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
Один бинарник MCP-сервера для MySQL, MariaDB, PostgreSQL и SQLite: запросы только на чтение по умолчанию и маскировка ПДн
MySQL MCP Server Pro
mysql_mcp_server_pro
MCP-сервер для MySQL: выполняет SQL с ролями доступа, ищет таблицы по комментариям и разбирает блокировки, индексы и планы запросов
Платформа мониторинга SQL Server, MySQL и PostgreSQL с MCP на 11 инструментов: агент читает метрики, а не сами базы.
MCP-сервер Dremio: агент смотрит таблицы, ищет закономерности в данных и разбирает нагрузку кластера.
Официальный MCP-сервер MongoDB: запросы и агрегации к базам, управление индексами, кластерами Atlas и локальными развертываниями
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| GreptimeDB MCP Server (эта карточка) | да | ключ необязателен | 29 | |
| ClickHouse MCP Server | нет | API-ключ | 904 | аналитическая база ClickHouse, без PromQL и конвейеров логов |
| Prometheus MCP Server | да | не нужна | 141 | запросы к Prometheus, логов и трасс там нет |
| Grafana MCP Server | да | API-ключ | 3 663 | работает с дашбордами Grafana поверх источников данных |
Коротко о README
В документации собраны быстрая установка, таблицы инструментов, переменные окружения и аргументы командной строки, режим HTTP-сервера и защита от подмены DNS. Отдельно названы подсказки для LLM и индекс навыков GreptimeDB для задач развертывания и настройки.