← Index

io.github.GreptimeTeam/greptimedb-mcp-server

io.github.GreptimeTeam/greptimedb-mcp-server·v0.4.7·Monitoring & Logs
Quality Score
78
/100

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

§01  Install
Claude Desktop (uvx)
{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "env": {
        "GREPTIMEDB_HOST": "<greptimedb_host>",
        "GREPTIMEDB_PORT": "<greptimedb_port>",
        "GREPTIMEDB_USER": "<greptimedb_user>",
        "GREPTIMEDB_PASSWORD": "<your-greptimedb_password>",
        "GREPTIMEDB_DATABASE": "<greptimedb_database>",
        "GREPTIMEDB_TIMEZONE": "<greptimedb_timezone>",
        "GREPTIMEDB_POOL_SIZE": "<greptimedb_pool_size>",
        "GREPTIMEDB_HTTP_PORT": "<greptimedb_http_port>",
        "GREPTIMEDB_HTTP_PROTOCOL": "<greptimedb_http_protocol>",
        "GREPTIMEDB_MASK_ENABLED": "<greptimedb_mask_enabled>",
        "GREPTIMEDB_MASK_PATTERNS": "<greptimedb_mask_patterns>",
        "GREPTIMEDB_AUDIT_ENABLED": "<greptimedb_audit_enabled>"
      }
    }
  }
}
§02  Environment variables
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 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)

§03  MCP Quality Score  ·  methodology
freshness
23
completeness
10
installability
25
documentation
15
stability
5
§04  Alternatives in Monitoring & Logs