How do I connect Greptimedb MCP Server to Claude?

Run `claude mcp add greptimedb-mcp-server -- npx -y @modelcontextprotocol/inspector uv --directory . run -m greptimedb_mcp_server.server` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.

Is Greptimedb MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Greptimedb MCP Server do?

Greptimedb MCP Server documents 6 tools to the agent, including describe_table, execute_sql, execute_tql. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Greptimedb MCP Server

Unclaimed

by GreptimeTeam

A Model Context Protocol (MCP) server for GreptimeDB

Set up this server

Compare servers My Stack

01 / Choose your client

02 / Before you connect

Authentication is not specified. Check the project instructions before connecting.

Install the runtime required by the project and make it available to your client.

Project instructionsEnvironment variable names (optional)

Use names from the project instructions, separated by commas. Enter names only, never secret values.

03 / Add the configuration

Source: generated from public install instructions

claude mcp add --transport stdio 'greptimedb-mcp-server' -- 'npx' '-y' '@modelcontextprotocol/inspector' 'uv' '--directory' '.' 'run' '-m' 'greptimedb_mcp_server.server'

Run in your terminal after replacing any placeholders.

04 / Check it in your client

Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.

greptimedbmcp-serverobservability-datatime-series-analysisobservability

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

6 of 6 tools

Documented tools (6)

From project documentation. A server handshake does not verify each tool’s description or behavior.

describe_table

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

execute_sql

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

execute_tql

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

explain_query

Analyze SQL or TQL query execution plans (analyze=true for runtime stats; add verbose=true alongside analyze=true for per-partition scan metrics and index-pruning counters)

health_check

Check database connection status and server version

query_range

Execute time-window aggregation queries with RANGE/ALIGN syntax

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Greptimedb MCP Server

How do I connect Greptimedb MCP Server to Claude?: Run `claude mcp add greptimedb-mcp-server -- npx -y @modelcontextprotocol/inspector uv --directory . run -m greptimedb_mcp_server.server` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
Is Greptimedb MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Greptimedb MCP Server do?: Greptimedb MCP Server documents 6 tools to the agent, including describe_table, execute_sql, execute_tql. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.