Greptimedb MCP Server
Greptimedb MCP Server is an MCP server that adds cloud and DevOps tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Query GreptimeDB metrics, logs and traces with SQL, TQL and RANGE. It has 29 GitHub stars, is released under the MIT license and runs locally with uvx greptimedb-mcp-server.
github.com/GreptimeTeam/greptimedb-mcp-server (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
- Official
- Needs API key
- Cloud & DevOps
- MIT
- Active
Install Greptimedb MCP Server
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"greptimedb-mcp-server": {
"command": "uvx",
"args": [
"greptimedb-mcp-server"
],
"env": {
"GREPTIMEDB_PASSWORD": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env GREPTIMEDB_PASSWORD=your-value --transport stdio greptimedb-mcp-server -- uvx greptimedb-mcp-serverCursor
{
"mcpServers": {
"greptimedb-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"greptimedb-mcp-server"
],
"env": {
"GREPTIMEDB_PASSWORD": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"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).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
GREPTIMEDB_HOST | No | GreptimeDB host address |
GREPTIMEDB_PORT | No | GreptimeDB MySQL protocol port (default: 4002) |
GREPTIMEDB_USER | No | Database username |
GREPTIMEDB_PASSWORDsecret | No | Database password |
GREPTIMEDB_DATABASE | No | Database name to connect to |
GREPTIMEDB_TIMEZONE | No | Session timezone (default: UTC) |
GREPTIMEDB_POOL_SIZE | No | Connection pool size (default: 5) |
GREPTIMEDB_HTTP_PORT | No | HTTP API port for pipeline/dashboard management (default: 4000) |
GREPTIMEDB_HTTP_PROTOCOL | No | HTTP protocol for pipeline/dashboard API: http or https (default: http) |
GREPTIMEDB_MASK_ENABLED | No | Enable sensitive data masking (default: true) |
GREPTIMEDB_MASK_PATTERNS | No | Additional column name patterns for data masking (comma-separated) |
GREPTIMEDB_AUDIT_ENABLED | No | Enable audit logging for tool invocations (default: true) |
GREPTIMEDB_ALLOW_WRITE | No | Allow write/destructive SQL (DDL/DML) via execute_sql by skipping the security gate. DANGEROUS: only use on local or test instances (default: false) |
Tools (8)
Parsed from the Tools section of the README; check the repository for the current list.
execute_sqlExecute SQL queries with format (csv/json/markdown) and limit options
execute_tqlExecute TQL (PromQL-compatible) queries for time-series analysis
query_rangeExecute time-window aggregation queries with RANGE/ALIGN syntax
search_table_semanticsFind tables by observability concept, ranked by matched terms; searches table names, semantic options, and entity…
query_semantic_graphQuery the semantic graph: summary (what it contains), entities (nodes), relationships (edges) over a required time…
describe_tableInspect a table profile: schema, semantic metadata, latest sample rows, and query guidance
explain_queryAnalyze SQL or TQL query execution plans (analyze=true for runtime stats; add verbose=true alongside analyze=true for…
health_checkCheck database connection status and server version
About Greptimedb MCP Server
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
Similar MCP servers
More cloud & devops MCP servers
Bitrise
bitrise-io/bitrise-mcp
Set up & manage mobile CI/CD on Bitrise: build, test, distribute iOS, Android, Flutter, RN apps.
Active · last commit Nov 10, 2026
OfficialCloud & DevOpsGoLocalstack MCP Server
localstack/localstack-mcp-server
A LocalStack MCP Server providing essential tools for local cloud development & testing.
Maintained · last commit Nov 13, 2026
OfficialCloud & DevOpsTypeScriptContainerization Assist
Azure/containerization-assist
TypeScript MCP server for AI-powered containerization workflows with Docker and Kubernetes support.
Active · last commit Nov 9, 2026
OfficialCloud & DevOpsTypeScriptVectreal
Vectreal/vectreal-platform
Upload, publish and embed 3D models on any website from your agent.
Active · last commit Nov 15, 2026
OfficialCloud & DevOpsTypeScriptEverr
everr-labs/everr
Query your traces, logs, metrics and GitHub Actions CI runs in Everr with read-only SQL.
Active · last commit Nov 15, 2026
OfficialCloud & DevOpsTypeScriptWorldmonitor
koala73/worldmonitor
Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface.
Active · last commit Nov 16, 2026
Cloud & DevOpsTypeScript
How do I install the Greptimedb MCP Server MCP server?
Add the command uvx greptimedb-mcp-server to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Greptimedb MCP Server free?
The server is open source under the MIT license, so running it is free. It needs credentials (GREPTIMEDB_PASSWORD) for the service it connects to, which may require a paid account.
Is Greptimedb MCP Server actively maintained?
The most recent commit was on Oct 12, 2026. The latest release is v0.6.1, published Oct 12, 2026. appsgit only lists MCP servers with a commit in the last six months.