greptimedb-mcp-server

Query and analyze GreptimeDB metrics, logs and traces via SQL, TQL and RANGE queries.

stdio v0.4.7

Connection Configuration

Add this to your AI agent's MCP config file to connect.

Run in your terminal:

claude mcp add io.github.greptimeteam--greptimedb-mcp-server -- uvx

Transport

stdio

Authentication

None

Version

v0.4.7

Server Name

io.github.GreptimeTeam/greptimedb-mcp-server

Last Updated

Mar 2, 2026

How to install and connect this MCP server.

Environment variables you must provide when running this server.

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