greptimedb-mcp-server — MCP-сервер для Claude Code
Сервер подключает агента к GreptimeDB для чтения метрик и логов через SQL или TQL. Пригодится при анализе телеметрии, настройке пайплайнов или дашбордов.
claude mcp add --env GREPTIMEDB_HOST=<GREPTIMEDB_HOST> --env GREPTIMEDB_PORT=<GREPTIMEDB_PORT> --env GREPTIMEDB_USER=<GREPTIMEDB_USER> --env GREPTIMEDB_PASSWORD=<GREPTIMEDB_PASSWORD> --env GREPTIMEDB_DATABASE=<GREPTIMEDB_DATABASE> --transport stdio greptimedb-mcp-server -- uvx greptimedb-mcp-serverЧто делает greptimedb-mcp-server
Этот MCP-сервер открывает агенту доступ к базе GreptimeDB. С его помощью модель выполняет аналитические запросы на SQL или PromQL-совместимом TQL, а также изучает структуру таблиц через describe_table. Для отладки медленных выборок предусмотрен вызов explain_query со статистикой партиций.
Безопасность настроена строго. Запись по умолчанию заблокирована параметром GREPTIMEDB_ALLOW_WRITE=false, поэтому сервер не меняет схему или данные без явного флага. Объём одного ответа ограничен переменной GREPTIMEDB_MAX_RESULT_BYTES (по умолчанию 1048576 байт), из-за чего слишком длинные выборки автоматически урезаются.
Для расширенной аналитики важна версия базы. Инструменты семантического графа query_semantic_graph и чтение entity_declarations требуют GreptimeDB 1.3. Если системные таблицы недоступны аккаунту, сервер скроет эти функции при запуске.
Какие задачи решает
- выполнить аналитические запросы к метрикам и логам на SQL или TQL
- проверить план выполнения запроса со статистикой сканирования партиций
- протестировать конфигурацию пайплайна разбора данных без записи в базу
- создать или обновить описание дашборда Perses
Примеры запросов агенту
- Выполни SQL-запрос к таблице системных логов и покажи последние десять ошибок
- Запусти explain_query с флагом analyze для медленного TQL-запроса по метрике latency
- Протестируй конфигурацию парсинга с помощью dryrun_pipeline на переданных строках
Как установить greptimedb-mcp-server
Командой платформы
claude mcp add --env GREPTIMEDB_HOST=<GREPTIMEDB_HOST> --env GREPTIMEDB_PORT=<GREPTIMEDB_PORT> --env GREPTIMEDB_USER=<GREPTIMEDB_USER> --env GREPTIMEDB_PASSWORD=<GREPTIMEDB_PASSWORD> --env GREPTIMEDB_DATABASE=<GREPTIMEDB_DATABASE> --transport stdio greptimedb-mcp-server -- uvx greptimedb-mcp-serverВместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from greptimedb-mcp-server <команда>
Командой платформы
codex mcp add greptimedb-mcp-server --env GREPTIMEDB_HOST=<GREPTIMEDB_HOST> --env GREPTIMEDB_PORT=<GREPTIMEDB_PORT> --env GREPTIMEDB_USER=<GREPTIMEDB_USER> --env GREPTIMEDB_PASSWORD=<GREPTIMEDB_PASSWORD> --env GREPTIMEDB_DATABASE=<GREPTIMEDB_DATABASE> -- uvx greptimedb-mcp-serverВместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from greptimedb-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"greptimedb-mcp-server": {
"command": "uvx",
"args": [
"greptimedb-mcp-server"
],
"env": {
"GREPTIMEDB_HOST": "<GREPTIMEDB_HOST>",
"GREPTIMEDB_PORT": "<GREPTIMEDB_PORT>",
"GREPTIMEDB_USER": "<GREPTIMEDB_USER>",
"GREPTIMEDB_PASSWORD": "<GREPTIMEDB_PASSWORD>",
"GREPTIMEDB_DATABASE": "<GREPTIMEDB_DATABASE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from greptimedb-mcp-server <команда>
Файл настроек
{
"servers": {
"greptimedb-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"greptimedb-mcp-server"
],
"env": {
"GREPTIMEDB_HOST": "<GREPTIMEDB_HOST>",
"GREPTIMEDB_PORT": "<GREPTIMEDB_PORT>",
"GREPTIMEDB_USER": "<GREPTIMEDB_USER>",
"GREPTIMEDB_PASSWORD": "<GREPTIMEDB_PASSWORD>",
"GREPTIMEDB_DATABASE": "<GREPTIMEDB_DATABASE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from greptimedb-mcp-server <команда>
Командой платформы
gemini mcp add -e GREPTIMEDB_HOST=<GREPTIMEDB_HOST> -e GREPTIMEDB_PORT=<GREPTIMEDB_PORT> -e GREPTIMEDB_USER=<GREPTIMEDB_USER> -e GREPTIMEDB_PASSWORD=<GREPTIMEDB_PASSWORD> -e GREPTIMEDB_DATABASE=<GREPTIMEDB_DATABASE> greptimedb-mcp-server uvx greptimedb-mcp-serverВместо <…> подставьте свои значения. Ещё 8 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from greptimedb-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о greptimedb-mcp-server
Как установить greptimedb-mcp-server в Claude Code?
Выполните команду claude mcp add greptimedb-mcp-server -e GREPTIMEDB_PASSWORD=<GREPTIMEDB_PASSWORD> -- uvx greptimedb-mcp-server.
Что делает greptimedb-mcp-server?
Сервер предоставляет инструменты для чтения метрик, трассировок и логов из GreptimeDB, отладки запросов и управления пайплайнами обработки данных.
Какая версия GreptimeDB нужна для семантического графа?
Инструмент query_semantic_graph требует GreptimeDB 1.3 и доступ к представлениям в схеме greptime_private. На старых версиях сервер отключит этот инструмент.
