io.github.GreptimeTeam/greptimedb-mcp-server MCP Server

Name: io.github.GreptimeTeam/greptimedb-mcp-server MCP Server
Author: io.github.GreptimeTeam

io.github.GreptimeTeam/greptimedb-mcp-server

Repository Registry

What is the io.github.GreptimeTeam/greptimedb-mcp-server MCP server?

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

How to install io.github.GreptimeTeam/greptimedb-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server",
        "--host",
        "--port",
        "--database",
        "--user",
        "--password",
        "--timezone"
      ],
      "env": {
        "GREPTIMEDB_HOST": "<YOUR_GREPTIMEDB_HOST>",
        "GREPTIMEDB_PORT": "<YOUR_GREPTIMEDB_PORT>",
        "GREPTIMEDB_USER": "<YOUR_GREPTIMEDB_USER>",
        "GREPTIMEDB_PASSWORD": "<YOUR_GREPTIMEDB_PASSWORD>",
        "GREPTIMEDB_DATABASE": "<YOUR_GREPTIMEDB_DATABASE>",
        "GREPTIMEDB_TIMEZONE": "<YOUR_GREPTIMEDB_TIMEZONE>",
        "GREPTIMEDB_POOL_SIZE": "<YOUR_GREPTIMEDB_POOL_SIZE>",
        "GREPTIMEDB_HTTP_PORT": "<YOUR_GREPTIMEDB_HTTP_PORT>",
        "GREPTIMEDB_HTTP_PROTOCOL": "<YOUR_GREPTIMEDB_HTTP_PROTOCOL>",
        "GREPTIMEDB_MASK_ENABLED": "<YOUR_GREPTIMEDB_MASK_ENABLED>",
        "GREPTIMEDB_MASK_PATTERNS": "<YOUR_GREPTIMEDB_MASK_PATTERNS>",
        "GREPTIMEDB_AUDIT_ENABLED": "<YOUR_GREPTIMEDB_AUDIT_ENABLED>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server",
        "--host",
        "--port",
        "--database",
        "--user",
        "--password",
        "--timezone"
      ],
      "env": {
        "GREPTIMEDB_HOST": "<YOUR_GREPTIMEDB_HOST>",
        "GREPTIMEDB_PORT": "<YOUR_GREPTIMEDB_PORT>",
        "GREPTIMEDB_USER": "<YOUR_GREPTIMEDB_USER>",
        "GREPTIMEDB_PASSWORD": "<YOUR_GREPTIMEDB_PASSWORD>",
        "GREPTIMEDB_DATABASE": "<YOUR_GREPTIMEDB_DATABASE>",
        "GREPTIMEDB_TIMEZONE": "<YOUR_GREPTIMEDB_TIMEZONE>",
        "GREPTIMEDB_POOL_SIZE": "<YOUR_GREPTIMEDB_POOL_SIZE>",
        "GREPTIMEDB_HTTP_PORT": "<YOUR_GREPTIMEDB_HTTP_PORT>",
        "GREPTIMEDB_HTTP_PROTOCOL": "<YOUR_GREPTIMEDB_HTTP_PROTOCOL>",
        "GREPTIMEDB_MASK_ENABLED": "<YOUR_GREPTIMEDB_MASK_ENABLED>",
        "GREPTIMEDB_MASK_PATTERNS": "<YOUR_GREPTIMEDB_MASK_PATTERNS>",
        "GREPTIMEDB_AUDIT_ENABLED": "<YOUR_GREPTIMEDB_AUDIT_ENABLED>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server",
        "--host",
        "--port",
        "--database",
        "--user",
        "--password",
        "--timezone"
      ],
      "env": {
        "GREPTIMEDB_HOST": "<YOUR_GREPTIMEDB_HOST>",
        "GREPTIMEDB_PORT": "<YOUR_GREPTIMEDB_PORT>",
        "GREPTIMEDB_USER": "<YOUR_GREPTIMEDB_USER>",
        "GREPTIMEDB_PASSWORD": "<YOUR_GREPTIMEDB_PASSWORD>",
        "GREPTIMEDB_DATABASE": "<YOUR_GREPTIMEDB_DATABASE>",
        "GREPTIMEDB_TIMEZONE": "<YOUR_GREPTIMEDB_TIMEZONE>",
        "GREPTIMEDB_POOL_SIZE": "<YOUR_GREPTIMEDB_POOL_SIZE>",
        "GREPTIMEDB_HTTP_PORT": "<YOUR_GREPTIMEDB_HTTP_PORT>",
        "GREPTIMEDB_HTTP_PROTOCOL": "<YOUR_GREPTIMEDB_HTTP_PROTOCOL>",
        "GREPTIMEDB_MASK_ENABLED": "<YOUR_GREPTIMEDB_MASK_ENABLED>",
        "GREPTIMEDB_MASK_PATTERNS": "<YOUR_GREPTIMEDB_MASK_PATTERNS>",
        "GREPTIMEDB_AUDIT_ENABLED": "<YOUR_GREPTIMEDB_AUDIT_ENABLED>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "greptimedb-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server",
        "--host",
        "--port",
        "--database",
        "--user",
        "--password",
        "--timezone"
      ],
      "env": {
        "GREPTIMEDB_HOST": "<YOUR_GREPTIMEDB_HOST>",
        "GREPTIMEDB_PORT": "<YOUR_GREPTIMEDB_PORT>",
        "GREPTIMEDB_USER": "<YOUR_GREPTIMEDB_USER>",
        "GREPTIMEDB_PASSWORD": "<YOUR_GREPTIMEDB_PASSWORD>",
        "GREPTIMEDB_DATABASE": "<YOUR_GREPTIMEDB_DATABASE>",
        "GREPTIMEDB_TIMEZONE": "<YOUR_GREPTIMEDB_TIMEZONE>",
        "GREPTIMEDB_POOL_SIZE": "<YOUR_GREPTIMEDB_POOL_SIZE>",
        "GREPTIMEDB_HTTP_PORT": "<YOUR_GREPTIMEDB_HTTP_PORT>",
        "GREPTIMEDB_HTTP_PROTOCOL": "<YOUR_GREPTIMEDB_HTTP_PROTOCOL>",
        "GREPTIMEDB_MASK_ENABLED": "<YOUR_GREPTIMEDB_MASK_ENABLED>",
        "GREPTIMEDB_MASK_PATTERNS": "<YOUR_GREPTIMEDB_MASK_PATTERNS>",
        "GREPTIMEDB_AUDIT_ENABLED": "<YOUR_GREPTIMEDB_AUDIT_ENABLED>"
      }
    }
  }
}

Claude Code

claude mcp add greptimedb-mcp-server --env GREPTIMEDB_HOST=<YOUR_GREPTIMEDB_HOST> --env GREPTIMEDB_PORT=<YOUR_GREPTIMEDB_PORT> --env GREPTIMEDB_USER=<YOUR_GREPTIMEDB_USER> --env GREPTIMEDB_PASSWORD=<YOUR_GREPTIMEDB_PASSWORD> --env GREPTIMEDB_DATABASE=<YOUR_GREPTIMEDB_DATABASE> --env GREPTIMEDB_TIMEZONE=<YOUR_GREPTIMEDB_TIMEZONE> --env GREPTIMEDB_POOL_SIZE=<YOUR_GREPTIMEDB_POOL_SIZE> --env GREPTIMEDB_HTTP_PORT=<YOUR_GREPTIMEDB_HTTP_PORT> --env GREPTIMEDB_HTTP_PROTOCOL=<YOUR_GREPTIMEDB_HTTP_PROTOCOL> --env GREPTIMEDB_MASK_ENABLED=<YOUR_GREPTIMEDB_MASK_ENABLED> --env GREPTIMEDB_MASK_PATTERNS=<YOUR_GREPTIMEDB_MASK_PATTERNS> --env GREPTIMEDB_AUDIT_ENABLED=<YOUR_GREPTIMEDB_AUDIT_ENABLED> -- uvx greptimedb-mcp-server --host --port --database --user --password --timezone