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.
DOCUMENTED COMMAND
pip install greptimedb-mcp-server Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- Install greptimedb-mcp-server with Python 3.11+; configure GREPTIMEDB_HOST, GREPTIMEDB_DATABASE, user and password. Start stdio with GREPTIMEDB_ALLOW_WRITE=false.
- 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.
https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/README.md
Supports: description, setup, capabilities, review, limitations
https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/LICENSE.md
Supports: license
- Pinned package metadata ↗Checked
https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/pyproject.toml
Supports: install, language, review
https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/src/greptimedb_mcp_server/config.py
Supports: review, install, access, limitations