GreptimeDB用のモデルコンテキストプロトコル(MCP)サーバー — 1つのエンジンでメトリック、ログ、トレースを処理するオープンソースの保守性データベース。

AI アシスタントが、SQL、TQL(PromQL-compatible)、および RANGE クエリを使用して GreptimeDB を照会および解析できるようにします。また、既読のみの執行やデータマスキングなどの組み込みセキュリティ機能を備えています。

クイックスタート

Claude Desktop では、macOS で config (~/Library/Application Support/Claude/claude_desktop_config.json) にこれを追加します。

##特徴

ツール

| ツール | 概要 | お問い合わせ | [execute_sql | フォーマット(csv/json/markdown)と制限オプションでSQLクエリを実行 | | [execute_tql | タイムシリーズ解析のためのTQL(PromQL)クエリの実行 | | [query_range | RANGE/ALIGN 構文でタイムウィンドウ集計クエリを実行 | | [search_table_semantics | 一致した用語でランク付けされた、観察性概念によって表を検索し、テーブル名、セマンティックオプション、およびエンティティティ宣言を検索します。 [[schema]検索するためにデータベースを選択 | | [query_semantic_graph|セマンティックグラフの問い合わせ:[[T7、[entities(ノード)、[relationships(エッジ)) 必須時間ウィンドウ上の |

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.