What query languages does this MCP server support?

The server supports SQL, TQL (GreptimeDB's time-series query language), and RANGE queries for flexible metric, log, and trace analysis. All queries execute against your connected GreptimeDB instance.

How do I authenticate and connect to my GreptimeDB instance?

Set the environment variables GREPTIMEDB_HOST, GREPTIMEDB_PORT (default 4002), GREPTIMEDB_USER, GREPTIMEDB_PASSWORD, and GREPTIMEDB_DATABASE before launching the server. The server uses MySQL protocol on the specified port.

Does this server mask sensitive data in query results?

Yes, sensitive data masking is enabled by default (GREPTIMEDB_MASK_ENABLED=true). You can disable it by setting the environment variable to false if your use case doesn't require redaction.

Can I use this server with HTTPS and custom connection pools?

Yes. Set GREPTIMEDB_HTTP_PROTOCOL to 'https' for the HTTP pipeline API, and adjust GREPTIMEDB_POOL_SIZE (default 5) to tune concurrent connections. The HTTP API runs on port 4000 by default.

What timezone should I use for time-series queries?

Set GREPTIMEDB_TIMEZONE to your preferred timezone (default is UTC). This affects how timestamps are interpreted and displayed in query results, which is critical for accurate time-range analysis.

MCP ServerSTDIOOfficialv0.4.7

Greptimeteam Greptimedb MCP Server

Query and analyze metrics, logs, and traces stored in GreptimeDB using SQL, TQL, and RANGE queries. Built for developers integrating observability data into AI workflows via the Model Context Protocol.

io.github.GreptimeTeam/greptimedb-mcp-server

Try MCP with AI models View source

Hosted URL

Local install

Transport

STDIO

Auth

No auth required

What the Greptimeteam Greptimedb MCP server does

How models use it and what it is built for.

Connect to Greptimeteam Greptimedb

Local install — runs as a subprocess.

uvx greptimedb-mcp-server==0.4.7

Environment variables

Configuration this server reads at startup.

GREPTIMEDB_HOST
GreptimeDB host address
GREPTIMEDB_PORT
GreptimeDB MySQL protocol port (default: 4002)
GREPTIMEDB_USER
Database username
GREPTIMEDB_PASSWORDSecret
Database password
GREPTIMEDB_DATABASE
Database name to connect to
GREPTIMEDB_TIMEZONE
Session timezone (default: UTC)
GREPTIMEDB_POOL_SIZE
Connection pool size (default: 5)
GREPTIMEDB_HTTP_PORT
HTTP API port for pipeline management (default: 4000)
GREPTIMEDB_HTTP_PROTOCOL
HTTP protocol for pipeline API: http or https (default: http)
GREPTIMEDB_MASK_ENABLED
Enable sensitive data masking (default: true)
GREPTIMEDB_MASK_PATTERNS
Additional column name patterns for data masking (comma-separated)
GREPTIMEDB_AUDIT_ENABLED
Enable audit logging for tool invocations (default: true)

Resources

Where to find authoritative docs and source for Greptimeteam Greptimedb.

Source repository

Example prompts for Greptimeteam Greptimedb

Paste any of these into Agent Studio after connecting Greptimeteam Greptimedb.

Show me the top 10 CPU usage spikes in the last hour using a RANGE query
Query the metrics table for average response latency grouped by service name
Analyze error logs from the past 24 hours and summarize failure patterns
Explain how to configure GREPTIMEDB_MASK_ENABLED for sensitive metric redaction

Greptimeteam Greptimedb MCP server — FAQ

Common questions about connecting and running Greptimeteam Greptimedb.

What query languages does this MCP server support?
The server supports SQL, TQL (GreptimeDB's time-series query language), and RANGE queries for flexible metric, log, and trace analysis. All queries execute against your connected GreptimeDB instance.
How do I authenticate and connect to my GreptimeDB instance?
Set the environment variables GREPTIMEDB_HOST, GREPTIMEDB_PORT (default 4002), GREPTIMEDB_USER, GREPTIMEDB_PASSWORD, and GREPTIMEDB_DATABASE before launching the server. The server uses MySQL protocol on the specified port.
Does this server mask sensitive data in query results?
Yes, sensitive data masking is enabled by default (GREPTIMEDB_MASK_ENABLED=true). You can disable it by setting the environment variable to false if your use case doesn't require redaction.
Can I use this server with HTTPS and custom connection pools?
Yes. Set GREPTIMEDB_HTTP_PROTOCOL to 'https' for the HTTP pipeline API, and adjust GREPTIMEDB_POOL_SIZE (default 5) to tune concurrent connections. The HTTP API runs on port 4000 by default.
What timezone should I use for time-series queries?
Set GREPTIMEDB_TIMEZONE to your preferred timezone (default is UTC). This affects how timestamps are interpreted and displayed in query results, which is critical for accurate time-range analysis.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 30+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio

Related servers

Judges Panel

45 judges that evaluate AI-generated code for security, cost, and quality with built-in AST.

Addozhang Nexus

Query Sonatype Nexus Repository (OSS/Pro) for Maven, Python, and Docker artifacts

Cyanheads MCP Ts Template

TypeScript template for building MCP servers with declarative tooling, observability, and auth.

Chernistry Bernstein

Declarative agent orchestration for engineering teams