Greptimedb MCP Server

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

claude mcp add --env GREPTIMEDB_PASSWORD=your-value --transport stdio greptimedb-mcp-server -- uvx greptimedb-mcp-server

{
  "mcpServers": {
    "greptimedb-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "env": {
        "GREPTIMEDB_PASSWORD": "your-value"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "greptimedb_password",
      "description": "GREPTIMEDB_PASSWORD",
      "password": true
    }
  ],
  "servers": {
    "greptimedb-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "greptimedb-mcp-server"
      ],
      "env": {
        "GREPTIMEDB_PASSWORD": "${input:greptimedb_password}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

• execute_sql

  Execute SQL queries with format (csv/json/markdown) and limit options

• execute_tql

  Execute TQL (PromQL-compatible) queries for time-series analysis

• query_range

  Execute time-window aggregation queries with RANGE/ALIGN syntax

• search_table_semantics

  Find tables by observability concept, ranked by matched terms; searches table names, semantic options, and entity…

• query_semantic_graph

  Query the semantic graph: summary (what it contains), entities (nodes), relationships (edges) over a required time…

• describe_table

  Inspect a table profile: schema, semantic metadata, latest sample rows, and query guidance

• explain_query

  Analyze SQL or TQL query execution plans (analyze=true for runtime stats; add verbose=true alongside analyze=true for…

• health_check

  Check database connection status and server version

A Model Context Protocol (MCP) server for GreptimeDB — an open-source observability database that handles metrics, logs, and traces in one engine.

• greptimedb
• mcp-server
• observability-data
• time-series-analysis
• observability