Home › Databases & Data › greptimedb-mcp-server

greptimedb-mcp-server

Query GreptimeDB metrics, logs and traces with SQL, TQL and RANGE. Manage pipelines and dashboards.

Official Python Local

★ 29 stars Last pushed 2026-09-23 License: MIT

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (pypi 0.6.0)

uvx greptimedb-mcp-server

Or add to your MCP client config:

{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "env": {
        "GREPTIMEDB_HOST": "<YOUR_VALUE>",
        "GREPTIMEDB_PORT": "<YOUR_VALUE>",
        "GREPTIMEDB_USER": "<YOUR_VALUE>",
        "GREPTIMEDB_PASSWORD": "<YOUR_VALUE>",
        "GREPTIMEDB_DATABASE": "<YOUR_VALUE>",
        "GREPTIMEDB_TIMEZONE": "<YOUR_VALUE>",
        "GREPTIMEDB_POOL_SIZE": "<YOUR_VALUE>",
        "GREPTIMEDB_HTTP_PORT": "<YOUR_VALUE>",
        "GREPTIMEDB_HTTP_PROTOCOL": "<YOUR_VALUE>",
        "GREPTIMEDB_MASK_ENABLED": "<YOUR_VALUE>",
        "GREPTIMEDB_MASK_PATTERNS": "<YOUR_VALUE>",
        "GREPTIMEDB_AUDIT_ENABLED": "<YOUR_VALUE>",
        "GREPTIMEDB_ALLOW_WRITE": "<YOUR_VALUE>"
      }
    }
  }
}

GREPTIMEDB_HOST — GreptimeDB host address
GREPTIMEDB_PORT — GreptimeDB MySQL protocol port (default: 4002)
GREPTIMEDB_USER — Database username
GREPTIMEDB_PASSWORD secret — 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/dashboard management (default: 4000)
GREPTIMEDB_HTTP_PROTOCOL — HTTP protocol for pipeline/dashboard 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)
GREPTIMEDB_ALLOW_WRITE — Allow write/destructive SQL (DDL/DML) via execute_sql by skipping the security gate. DANGEROUS: only use on local or test instances (default: false)