SERVER

Greptimedb MCP Server

Rank #2,783

io.github.GreptimeTeam/greptimedb-mcp-server

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

3 versions

29 GitHub stars

by greptimeteam (1 servers)View repository ↗Claim this server

First listed

Mar 12, 2025

Last publish date

Sep 14, 2026

OVERVIEW

Greptimedb MCP Server is a Model Context Protocol (MCP) server published by greptimeteam. It ranks #2,783 of 132,046 servers tracked on MCP Toplist, and its repository has 29 GitHub stars. Greptimedb MCP Server is listed across 4 registries — Official MCP, PulseMCP, mcp.so and Glama, with 3 tracked versions. It was first listed on Mar 12, 2025 and most recently updated on Sep 14, 2026.

STANDING

#2,783of 132,046 tracked serversTop 5%

Ranks ahead of 129,263 of 132,046 servers on MCP Toplist.

CONNECT

Use Greptimedb MCP Server

No setupRuns out of the box

No credentials or required configuration declared — add it to your MCP client and go.

Python package (PyPI)

claude mcp add greptimedb-mcp-server -e "GREPTIMEDB_HOST=<your GREPTIMEDB_HOST>" -e "GREPTIMEDB_PORT=<your GREPTIMEDB_PORT>" -e "GREPTIMEDB_USER=<your GREPTIMEDB_USER>" -e "GREPTIMEDB_PASSWORD=<your GREPTIMEDB_PASSWORD>" -e "GREPTIMEDB_DATABASE=<your GREPTIMEDB_DATABASE>" -e "GREPTIMEDB_TIMEZONE=<your GREPTIMEDB_TIMEZONE>" -e "GREPTIMEDB_POOL_SIZE=<your GREPTIMEDB_POOL_SIZE>" -e "GREPTIMEDB_HTTP_PORT=<your GREPTIMEDB_HTTP_PORT>" -e "GREPTIMEDB_HTTP_PROTOCOL=<your GREPTIMEDB_HTTP_PROTOCOL>" -e "GREPTIMEDB_MASK_ENABLED=<your GREPTIMEDB_MASK_ENABLED>" -e "GREPTIMEDB_MASK_PATTERNS=<your GREPTIMEDB_MASK_PATTERNS>" -e "GREPTIMEDB_AUDIT_ENABLED=<your GREPTIMEDB_AUDIT_ENABLED>" -e "GREPTIMEDB_ALLOW_WRITE=<your GREPTIMEDB_ALLOW_WRITE>" -- uvx greptimedb-mcp-server

Replace each placeholder with your own value before saving.

Python package (PyPI)

[mcp_servers.greptimedb-mcp-server]
command = "uvx"
args = ["greptimedb-mcp-server"]

[mcp_servers.greptimedb-mcp-server.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>"
GREPTIMEDB_ALLOW_WRITE = "<your GREPTIMEDB_ALLOW_WRITE>"

Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "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>",
        "GREPTIMEDB_ALLOW_WRITE": "<your GREPTIMEDB_ALLOW_WRITE>"
      }
    }
  }
}

Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "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>",
        "GREPTIMEDB_ALLOW_WRITE": "<your GREPTIMEDB_ALLOW_WRITE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "servers": {
    "greptimedb-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "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>",
        "GREPTIMEDB_ALLOW_WRITE": "<your GREPTIMEDB_ALLOW_WRITE>"
      }
    }
  }
}

Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "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>",
        "GREPTIMEDB_ALLOW_WRITE": "<your GREPTIMEDB_ALLOW_WRITE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.

Python package (PyPI)

{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "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>",
        "GREPTIMEDB_ALLOW_WRITE": "<your GREPTIMEDB_ALLOW_WRITE>"
      }
    }
  }
}

Replace each placeholder with your own value before saving.

BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

Markdown

[![MCP Toplist](https://mcptoplist.com/badge/io.github.GreptimeTeam%2Fgreptimedb-mcp-server.svg)](https://mcptoplist.com/server/io.github.GreptimeTeam%2Fgreptimedb-mcp-server)

HTML

<a href="https://mcptoplist.com/server/io.github.GreptimeTeam%2Fgreptimedb-mcp-server"><img src="https://mcptoplist.com/badge/io.github.GreptimeTeam%2Fgreptimedb-mcp-server.svg" alt="MCP Toplist: Top 5% of 132,046" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

REGISTRIES

Listed on 4 registries

ORGANIZATION

greptimeteam

Organization

greptimeteam

Servers in org

Versions across org

VERSIONS

Available versions (3)

Version	Published
0.6.0	Sep 14, 2026
0.4.7	Mar 2, 2026
0.1.0	Nov 25, 2024

FAQ

Frequently asked questions

Who maintains Greptimedb MCP Server?: Greptimedb MCP Server is maintained by greptimeteam, which publishes 1 MCP server (3 total versions) tracked on MCP Toplist.
Is Greptimedb MCP Server listed on the Official MCP Registry?: Yes — Greptimedb MCP Server is listed on the Official MCP Registry, alongside PulseMCP, mcp.so and Glama.
How many versions does Greptimedb MCP Server have?: MCP Toplist tracks 3 versions of Greptimedb MCP Server, most recently published on Sep 14, 2026.
Where can I find the source code for Greptimedb MCP Server?: The source code for Greptimedb MCP Server is hosted at github.com/greptimeteam/greptimedb-mcp-server.

Used in projects

Do you run this server?

Add to a project

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE

All MCP Servers Official MCP Servers GitHub MCP Servers Best MCP Servers Most Active MCP Servers New MCP Servers Best New MCP Servers