Skip to content
MCP server

Greptimedb MCP Server

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.6.0
Listing updated
6 days ago

About Greptimedb MCP Server

Greptimedb MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GREPTIMEDB_HOSTGreptimeDB host address
  • GREPTIMEDB_PORTGreptimeDB MySQL protocol port (default: 4002)
  • GREPTIMEDB_USERDatabase username
  • GREPTIMEDB_PASSWORDDatabase password
  • GREPTIMEDB_DATABASEDatabase name to connect to
  • GREPTIMEDB_TIMEZONESession timezone (default: UTC)
  • GREPTIMEDB_POOL_SIZEConnection pool size (default: 5)
  • GREPTIMEDB_HTTP_PORTHTTP API port for pipeline/dashboard management (default: 4000)
  • GREPTIMEDB_HTTP_PROTOCOLHTTP protocol for pipeline/dashboard API: http or https (default: http)
  • GREPTIMEDB_MASK_ENABLEDEnable sensitive data masking (default: true)
  • GREPTIMEDB_MASK_PATTERNSAdditional column name patterns for data masking (comma-separated)
  • GREPTIMEDB_AUDIT_ENABLEDEnable audit logging for tool invocations (default: true)
  • GREPTIMEDB_ALLOW_WRITEAllow write/destructive SQL (DDL/DML) via execute_sql by skipping the security gate. DANGEROUS: only use on local or test instances (default: false)

Pricing

Open source

Greptimedb MCP Server FAQ

Is Greptimedb MCP Server free?

Yes. Greptimedb MCP Server is open source, so you can use and self-host it for free.

How do I add Greptimedb MCP Server to Claude Code?

Run this command in your terminal: claude mcp add greptimedb-mcp-server --env GREPTIMEDB_PASSWORD='<GREPTIMEDB_PASSWORD>' -- uvx greptimedb-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers