Greptimedb MCP Server - install, status & alternatives [2026]

01 · Install Greptimedb MCP Server

before you install - you'll need

Set GREPTIMEDB_HOST, GREPTIMEDB_USER, GREPTIMEDB_DATABASE, GREPTIMEDB_TIMEZONE, GREPTIMEDB_HTTP_PORT, GREPTIMEDB_HTTP_PROTOCOL, GREPTIMEDB_POOL_SIZE, GREPTIMEDB_MASK_ENABLED, GREPTIMEDB_AUDIT_ENABLED, GREPTIMEDB_ALLOW_WRITE, GREPTIMEDB_TRANSPORT before connecting. GREPTIMEDB_PORT is optional or environment-specific per the README.

Claude Code

claude mcp add greptimeteam-greptimedb-mcp-server -- uvx greptimedb-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "greptimeteam-greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package greptimedb-mcp-server - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.GreptimeTeam is GitHub-verified and matches the repo owner

03 · What Greptimedb MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can execute time-window aggregation queries with RANGE/ALIGN syntax, find tables by observability concept, ranked by matched terms, query the semantic graph: summary (what it contains), entities (nodes), relationships (edges) over a required time window, and inspect a table profile: schema, semantic metadata, latest sample rows, and query guidance.

Capability map

Tools grouped from the project's README - what Greptimedb MCP Server lets an agent do.

read & search

4 tools - e.g. Execute time-window aggregation queries with RANGE/ALIGN syntax; Find tables by observability concept, ranked by matched terms; searches table names, semantic options, and entity declarations; Query the…

query_range · search_table_semantics · query_semantic_graph · describe_table

run & execute

2 tools - e.g. Execute SQL queries with format (csv/json/markdown) and limit options; Execute TQL (PromQL-compatible) queries for time-series analysis

execute_sql · execute_tql

Explain

1 tool - e.g. 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-pruni

explain_query

Health

1 tool - e.g. Check database connection status and server version

health_check

Latest releases

v0.6.0 · 2026-09-14

Requires MCP Python SDK 2.x (#44). The SDK v1 FastMCP API is gone; installs that need it should stay on v0.5.2. · Three additions over GreptimeDB's semantic layer: · search_table_semantics finds tables by observability…

v0.5.2 · 2026-08-16

Fixes a startup failure on fresh installs. MCP Python SDK 2.0.0 removed mcp.server.fastmcp, and the dependency was declared as mcp>=1.8.0, so new installs resolved to 2.x and crashed with ModuleNotFoundError. Now…

v0.5.1 · 2026-06-17

add verbose mode to explain_query for scan-level metrics

04 · Who maintains Greptimedb MCP Server

greptimedb-mcp-server is maintained by greptimeteam. It's the only MCP server we track from this author; the repo dates to Mar 2025.

05 · Facts

repository: github.com/greptimeteam/greptimedb-mcp-server
category: DevOps & monitoring - ranked #27 of 120 actively-maintained DevOps & monitoring servers as of 2026-09-18.
release cadence: 2 releases in the last 90 days (latest 2026-09-14)
registry: io.github.GreptimeTeam/greptimedb-mcp-server (active, first published 2026-03-02 · 2 versions)
packages: pypi:greptimedb-mcp-server

06 · Greptimedb MCP Server FAQ

Is Greptimedb MCP Server still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-14 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Greptimedb MCP Server do?

With this server connected, an agent can execute time-window aggregation queries with RANGE/ALIGN syntax, find tables by observability concept, ranked by matched terms, query the semantic graph: summary (what it contains), entities (nodes), relationships (edges) over a required time window, and inspect a table profile: schema, semantic metadata, latest sample rows, and query guidance.

How do I install Greptimedb MCP Server?

Run `uvx greptimedb-mcp-server`. The README documents 12 environment variables (GREPTIMEDB_HOST, GREPTIMEDB_PORT, GREPTIMEDB_USER…) to set first. Set GREPTIMEDB_HOST, GREPTIMEDB_USER, GREPTIMEDB_DATABASE, GREPTIMEDB_TIMEZONE, GREPTIMEDB_HTTP_PORT, GREPTIMEDB_HTTP_PROTOCOL, GREPTIMEDB_POOL_SIZE, GREPTIMEDB_MASK_ENABLED, GREPTIMEDB_AUDIT_ENABLED, GREPTIMEDB_ALLOW_WRITE, GREPTIMEDB_TRANSPORT before connecting. GREPTIMEDB_PORT is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Greptimedb MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Greptimedb MCP Server

Alternatives to Greptimedb MCP Server

Maintained DevOps & monitoring servers if Greptimedb MCP Server isn't the fit.

Pairs well with

Servers that cover what Greptimedb MCP Server doesn't - only shown when the pairing reason fits the companion.

More DevOps & monitoring MCP servers · Arduino MCP Server (hardware-mcp) · Homebutler · Zuul · Iris Eval MCP Server · Data Sentry

More Python MCP servers · Ihalent · Qai Consultant MCP · OpenHire · 哨兵 · Omni Lpr · Data Profiler MCP · see all