← Explore all mcp servers

DATABASE ANALYTICS / Greptime

GreptimeDB MCP Server

Query metrics, logs and traces using SQL, TQL and time-window aggregation with result masking.

“Query metrics, logs and traces using SQL, TQL and time-window aggregation with result masking.”

01 / THE REASONING

Why this made the selection.

  • Query metrics, logs and traces using SQL, TQL and time-window aggregation with result masking.
  • The setup documentation makes this operating boundary explicit: Use a database user with read grants. Write mode also enables pipeline and dashboard creation/deletion, not just SQL writes.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • README.md
  • LICENSE.md
  • pyproject.toml
  • src/greptimedb_mcp_server/config.py

Our findings

  • Use a database user with read grants. Write mode also enables pipeline and dashboard creation/deletion, not just SQL writes.
  • Masking and statement filtering are application controls, not a replacement for database permissions. Result byte limits can truncate the visible evidence.

Not established by this review

  • No server installation, authentication, live tool execution or isolation test was performed.
  • Package/container parity with the pinned source and transitive dependency security were not established.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Connect a server deliberately.

Upstream setup instructions ↗

DOCUMENTED COMMAND

pip install greptimedb-mcp-server

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

  1. Install greptimedb-mcp-server with Python 3.11+; configure GREPTIMEDB_HOST, GREPTIMEDB_DATABASE, user and password. Start stdio with GREPTIMEDB_ALLOW_WRITE=false.
  2. Verify the connected account, available tools and target resource before authorizing mutations.

Before you start

  • Pinned package Python requirement: >=3.11.
  • A compatible local process MCP client.
  • Use a database user with read grants. Write mode also enables pipeline and dashboard creation/deletion, not just SQL writes.

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/README.md

    Supports: description, setup, capabilities, review, limitations

  2. https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/LICENSE.md

    Supports: license

  3. Pinned package metadata ↗Checked

    https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/pyproject.toml

    Supports: install, language, review

  4. https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/src/greptimedb_mcp_server/config.py

    Supports: review, install, access, limitations

Evidence & Ask