Is Greptimedb MCP Server safe to use?

Greptimedb MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install Greptimedb MCP Server?

Greptimedb MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Greptimedb MCP Server do?

Greptimedb MCP Server provides 13 tools: execute_sql, execute_tql, query_range, describe_table, explain_query and 8 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Greptimedb MCP Server?

Greptimedb MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is Greptimedb MCP Server actively maintained?

Greptimedb MCP Server is recently maintained — last commit was 35 days ago. It has 27 GitHub stars.

Greptimedb MCP Server

greptimedb-mcp-server

Query and analyze GreptimeDB metrics, logs and traces via SQL, TQL and RANGE queries.

27 13 tools GitHub PyPI

No known CVEs

No license

Maintained

Last commit 35d ago

Works with most clients

Transport: stdio, sse, http

13 tools · ~583 tok

Grade B · 0.3% of 200K ctx

Edit this pageView history

Data Analytics

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "greptimedb": {
      "args": [
        "--host",
        "localhost",
        "--database",
        "public"
      ],
      "command": "greptimedb-mcp-server"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-greptimeteam-greptimedb-mcp-server)](https://mcppedia.org/s/io-github-greptimeteam-greptimedb-mcp-server)

Read me

What Greptimedb MCP Server does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'greptimedb-mcp-server' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

77/100across 5 weighted dimensions

How we score →

0255075100

−23

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked greptimedb-mcp-server against OSV.dev.

Inventory

Tools (13)

Click any tool to inspect its schema.

~583 tokens total

Inventory

Resources (1)

table_data

Browse tables via greptime URIs

greptime://{table}/data

Inventory

Prompts (7)

pipeline_creator

Template for creating pipelines

log_pipeline

Template for log pipeline analysis

metrics_analysis

Template for metrics analysis

promql_analysis

Template for PromQL analysis

iot_monitoring

Template for IoT monitoring

trace_analysis

Template for trace analysis

table_operation

Template for table operations

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Greptimedb MCP Server safe to use?: Greptimedb MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Greptimedb MCP Server?: Greptimedb MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Greptimedb MCP Server do?: Greptimedb MCP Server provides 13 tools: execute_sql, execute_tql, query_range, describe_table, explain_query and 8 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Greptimedb MCP Server?: Greptimedb MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is Greptimedb MCP Server actively maintained?: Greptimedb MCP Server is recently maintained — last commit was 35 days ago. It has 27 GitHub stars.

Similar servers

Others in data / analytics

View all →

Supabase MCP Server97

Manage Supabase projects — databases, auth, storage, and edge functions

2.7k 4

Observability Mcp95

MCP Server for GCP environment for interacting with various Observability APIs.

790 10

Firecrawl Mcp Server95

🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.

6.3k 4

Apify Mcp Server94

The Apify MCP server enables your AI agents to extract data from social media, search engines, maps, e-commerce sites, or any other website using thousands of ready-made scrapers, crawlers, and automation tools available on the Apify Store.

1.2k 1

MCP Security Weekly

Get CVE alerts and security updates for Greptimedb MCP Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

Data Analytics

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "greptimedb": {
      "args": [
        "--host",
        "localhost",
        "--database",
        "public"
      ],
      "command": "greptimedb-mcp-server"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-greptimeteam-greptimedb-mcp-server)](https://mcppedia.org/s/io-github-greptimeteam-greptimedb-mcp-server)

Read me

What Greptimedb MCP Server does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'greptimedb-mcp-server' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

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.

Enables AI assistants to query and analyze GreptimeDB using SQL, TQL (PromQL-compatible), and RANGE queries, with built-in security features like read-only enforcement and data masking.

Quick Start

# Install
pip install greptimedb-mcp-server

# Run (connects to localhost:4002 by default)
greptimedb-mcp-server --host localhost --database public

For Claude Desktop, add this to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "greptimedb": {
      "command": "greptimedb-mcp-server",
      "args": ["--host", "localhost", "--database", "public"]
    }
  }
}

Features

Tools

Tool	Description
`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
`describe_table`	Get table schema including column names, types, and constraints
`explain_query`	Analyze SQL or TQL query execution plans
`health_check`	Check database connection status and server version

Pipeline Management

Tool	Description
`list_pipelines`	List all pipelines or get details of a specific pipeline
`create_pipeline`	Create a new pipeline with YAML configuration
`dryrun_pipeline`	Test a pipeline with sample data without writing to database
`delete_pipeline`	Delete a specific version of a pipeline

Dashboard Management

Tool	Description
`list_dashboards`	List all Perses dashboard definitions
`create_dashboard`	Create or update a Perses dashboard definition
`delete_dashboard`	Delete a dashboard definition

Resources & Prompts

Resources: Browse tables via greptime://<table>/data URIs
Prompts: Built-in templates for common tasks — pipeline_creator, log_pipeline, metrics_analysis, promql_analysis, iot_monitoring, trace_analysis, table_operation

For LLM integration and prompt usage, see docs/llm-instructions.md.

Configuration

Environment Variables

GREPTIMEDB_HOST=localhost      # Database host
GREPTIMEDB_PORT=4002           # MySQL protocol port (default: 4002)
GREPTIMEDB_USER=root           # Database user
GREPTIMEDB_PASSWORD=           # Database password
GREPTIMEDB_DATABASE=public     # Database name
GREPTIMEDB_TIMEZONE=UTC        # Session timezone

# Optional
GREPTIMEDB_HTTP_PORT=4000      # HTTP API port for pipeline/dashboard management
GREPTIMEDB_HTTP_PROTOCOL=http  # HTTP protocol (http/https)
GREPTIMEDB_POOL_SIZE=5         # Connection pool size
GREPTIMEDB_MASK_ENABLED=true   # Enable sensitive data masking
GREPTIMEDB_MASK_PATTERNS=      # Additional patterns (comma-separated)
GREPTIMEDB_AUDIT_ENABLED=true  # Enable audit logging

# Transport (for HTTP server mode)
GREPTIMEDB_TRANSPORT=stdio     # stdio, sse, or streamable-http
GREPTIMEDB_LISTEN_HOST=0.0.0.0 # HTTP server bind host
GREPTIMEDB_LISTEN_PORT=8080    # HTTP server bind port
GREPTIMEDB_ALLOWED_HOSTS=      # DNS rebinding protection (c

... [View full README on GitHub](https://github.com/GreptimeTeam/greptimedb-mcp-server#readme)

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

77/100across 5 weighted dimensions

How we score →

0255075100

−23

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked greptimedb-mcp-server against OSV.dev.

Inventory

Tools (13)

Click any tool to inspect its schema.

~583 tokens total

Inventory

Resources (1)

table_data

Browse tables via greptime URIs

greptime://{table}/data

Inventory

Prompts (7)

pipeline_creator

Template for creating pipelines

log_pipeline

Template for log pipeline analysis

metrics_analysis

Template for metrics analysis

promql_analysis

Template for PromQL analysis

iot_monitoring

Template for IoT monitoring

trace_analysis

Template for trace analysis

table_operation

Template for table operations

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Greptimedb MCP Server safe to use?: Greptimedb MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Greptimedb MCP Server?: Greptimedb MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Greptimedb MCP Server do?: Greptimedb MCP Server provides 13 tools: execute_sql, execute_tql, query_range, describe_table, explain_query and 8 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Greptimedb MCP Server?: Greptimedb MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is Greptimedb MCP Server actively maintained?: Greptimedb MCP Server is recently maintained — last commit was 35 days ago. It has 27 GitHub stars.