Greptimedb MCP Server

by greptimeteamio.github.GreptimeTeam/greptimedb-mcp-serverv0.6.0

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

29Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active26d ago

Install Greptimedb MCP server

claude mcp add greptimedb -e GREPTIMEDB_PASSWORD='<greptimedb-password>' -- uvx greptimedb-mcp-server

{
  "mcpServers": {
    "greptimedb": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "env": {
        "GREPTIMEDB_PASSWORD": "<greptimedb-password>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "greptimedb": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "env": {
        "GREPTIMEDB_PASSWORD": "<greptimedb-password>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "greptimedb": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "env": {
        "GREPTIMEDB_PASSWORD": "<greptimedb-password>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "greptimedb": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "env": {
        "GREPTIMEDB_PASSWORD": "<greptimedb-password>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GREPTIMEDB_HOST	—	—	GreptimeDB host address
GREPTIMEDB_PORT	—	—	GreptimeDB MySQL protocol port (default: 4002)
GREPTIMEDB_USER	—	—	Database username
GREPTIMEDB_PASSWORD	—	yes	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)

Freshness

Active — last maintenance signal 26d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-14 · 26d ago · GitHub
Latest release
2026-09-14 · 26d ago · GitHub · v0.6.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-14 · 26d ago · official registry · v0.6.0

FAQ

›How do I install the Greptimedb MCP server in Claude Code?

Run: claude mcp add greptimedb -e GREPTIMEDB_PASSWORD='<greptimedb-password>' -- uvx greptimedb-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Greptimedb require an API key?

Yes. It expects GREPTIMEDB_PASSWORD, of which 1 is a secret.

›Can I use Greptimedb as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Greptimedb in the official MCP registry?

Yes, as io.github.GreptimeTeam/greptimedb-mcp-server.