greptimedb-mcp-serverA Model Context Protocol (MCP) server implementation for GreptimeDB

— (0)

Reviewed by Daniel Nikulshyn·Updated July 2026

Overview

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. Some notable features include executing SQL queries, analyzing query execution plans, checking database connection status, and managing pipelines and dashboards. Tools also include built-in Jinja templates for various tasks such as pipeline creation, log analysis, and query performance tuning.

Key features

execute_sql
execute_tql
query_range
describe_table
explain_query
health_check

Pricing

Model: Free
Category: MCP Servers
Rating: No reviews yet

Use cases

Observability Data Analysis

Use the MCP server to analyze metrics, logs, and traces stored in GreptimeDB

AI Assistant Integration

Integrate AI assistants with GreptimeDB using the MCP server for querying and analysis

Pros & Cons

Pros

Enables AI assistants to query GreptimeDB
Supports SQL, TQL, and RANGE queries
Built-in security features like read-only enforcement and data masking

Cons

Requires GreptimeDB setup
Limited write capabilities (default read-only)

Reviews

No reviews yet. Be the first!

Q&A

How do I configure the server for use with AI assistants like Claude Desktop?

Add an entry to Claude Desktop’s config file (e.g., `~/Library/Application Support/Claude/claude_desktop_config.json` on macOS) under `mcpServers` with the command and args (`host localhost`, `database public`). The assistant will then route queries through the MCP server.

Asked by Sanjay Gupta · Nov 4, 2025

What query languages and output formats does the server support?

It supports SQL, TQL (PromQL‑compatible) and RANGE queries. The `execute_sql` tool can return results in CSV, JSON, or Markdown, and you can limit rows with the `limit` option.

Asked by Aisha Khan · Nov 1, 2025

Is the MCP server read‑only or can it write data to GreptimeDB?

The server is primarily read‑only; it enforces read‑only access and includes data‑masking security. Write capabilities are limited and not enabled by default.

Asked by Tobias Hartmann · Aug 25, 2025

How do I install and start the greptimedb‑mcp‑server?

Install via pip (`pip install greptimedb-mcp-server`). By default it connects to `localhost:4002` using the `public` database; just run `greptimedb-mcp-server` and it will start listening on that address.

Asked by Paloma Ruiz · Aug 7, 2025