greptimedb-mcp-server

greptimedb-mcp-server is an MCP server. It reaches greptimedb. It needs GREPTIMEDB_PASSWORD to authenticate. Its repository has 29 GitHub stars and is licensed under MIT; we last read it on 2026-10-22.

This server implements the Model Context Protocol (MCP) for connecting to GreptimeDB.

MCP servers are packaged differently from each other -- some run via npx, some as a Docker image, some as a plain script you clone and run. greptimedb-mcp-server’s own README did not state one plainly enough for this page to quote it rather than guess, so it will not guess. The repository below states it.

15 tools documented in its README. An AI client calls these by name.

execute_sql

Execute SQL queries with format (csv/json/markdown) and limit options

execute_tql

Execute TQL (PromQL-compatible) queries for time-series analysis

query_range

Execute time-window aggregation queries with RANGE/ALIGN syntax

search_table_semantics

Find tables by observability concept, ranked by matched terms; searches table names, semantic options, and entity declarations. `schema` selects the database to search

query_semantic_graph

Query the semantic graph: `summary` (what it contains), `entities` (nodes), `relationships` (edges) over a required time window

describe_table

Inspect a table profile: schema, semantic metadata, latest sample rows, and query guidance

explain_query

Analyze SQL or TQL query execution plans (`analyze=true` for runtime stats; add `verbose=true` alongside `analyze=true` for per-partition scan metrics and index-pruning counters)

health_check

Check database connection status and server version

list_pipelines

List all pipelines or get details of a specific pipeline

create_pipeline

Create a new pipeline with YAML configuration

dryrun_pipeline

Test a pipeline with sample data without writing to database

delete_pipeline

Delete a specific version of a pipeline

list_dashboards

List all Perses dashboard definitions

create_dashboard

Create or update a Perses dashboard definition

delete_dashboard

Delete a dashboard definition

Read from the README; names are kept only if the README contains them.

What does greptimedb-mcp-server do?

This server implements the Model Context Protocol (MCP) for connecting to GreptimeDB.

How do I install greptimedb-mcp-server?

Its README did not state an install command plainly enough for us to quote one, so we do not guess. The repository has the instructions: https://github.com/GreptimeTeam/greptimedb-mcp-server

What does greptimedb-mcp-server connect to, and what does it need?

It reaches greptimedb. The credentials we found in its source are GREPTIMEDB_PASSWORD.

Is greptimedb-mcp-server official and is it maintained?

We found nothing naming it as a vendor’s official server. Its repository has 29 GitHub stars and its state in our directory is listed. Its last commit we recorded was on 2026-10-12.

What licence does greptimedb-mcp-server use?

The repository declares the MIT licence.

• Introduction to Model Context Protocol (Claude Academy)
• The Hugging Face MCP course
• Build an AI agent: a path with skills and MCP servers to practise on