Greptimedb MCP Server
Query GreptimeDB metrics, logs and traces with SQL, TQL and RANGE. Manage pipelines and…
- 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-serverAdd 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 addressGREPTIMEDB_PORTGreptimeDB MySQL protocol port (default: 4002)GREPTIMEDB_USERDatabase usernameGREPTIMEDB_PASSWORDDatabase passwordGREPTIMEDB_DATABASEDatabase name to connect toGREPTIMEDB_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.