Сервер Model Context Protocol (MCP) для GreptimeDB — база данных с открытым исходным кодом, которая обрабатывает метрики, журналы и следы в одном движке.

Позволяет помощникам ИИ запрашивать и анализировать GreptimeDB с использованием SQL, TQL (PromQL-совместимых) и запросов RANGE со встроенными функциями безопасности, такими как правоприменение только для чтения и маскировка данных.

Быстрый старт

Для Claude Desktop добавьте это в конфигурацию ~/Library/Application Support/Claude/claude_desktop_config.json на macOS:

Особенности

Инструменты

| Инструмент | Описание [скрыто] [скрыто] [скрыто] [скрыто] | execute_sql | Выполнить SQL-запросы с форматом (csv/json/markdown) и ограничить опции | | execute_tql | Исполнить TQL (PromQL-совместимые) запросы для анализа временных рядов | | query_range | Выполнять запросы агрегации временных окон с синтаксисом RANGE/ALIGN | | search_table_semantics | Найти таблицы по концепции наблюдаемости, ранжированные по совпадающим терминам; искать названия таблиц, семантические опции и декларации объектов. schema выбирает базу данных для поиска | [[Т6]] [[Т7]] [[Т8]] [узлы] [[Т9]] [клетки]] [[Т7]] [[Т7]] [[Т]]] [[Т8]] [[Т9]] [клетки]] [[Т[9]] [клетки]] [[Т]]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]] [[Т]]] [[Т]] [[Т]]] [[Т]]] [[Т]] [[Т]]] [[Т]] [[Т]]] [[Т

greptimedb-mcp-server

A Model Context Protocol (MCP) server for GreptimeDB — an open-source observability database that handles metrics, logs, and traces in one engine.

Enables AI assistants to query and analyze GreptimeDB using SQL, TQL (PromQL-compatible), and RANGE queries, with built-in security features like read-only enforcement and data masking.

Quick Start

# Install
pip install greptimedb-mcp-server

# Run (connects to localhost:4002 by default)
greptimedb-mcp-server --host localhost --database public

For Claude Desktop, add this to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "greptimedb": {
      "command": "greptimedb-mcp-server",
      "args": ["--host", "localhost", "--database", "public"]
    }
  }
}

Features

Tools

search_table_semantics and the semantic metadata in describe_table read information_schema.table_semantics. A table appears there when it carries a greptime.semantic.* option or a built-in convention derives an entity declaration for it; other tables are absent. The server reads the view’s column list once per process and selects only the columns it exposes. entity_declarations requires GreptimeDB 1.3; on earlier versions it is reported as a missing column rather than as an empty declaration set.