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 actively maintained — last commit was 12 days ago. It has 28 GitHub stars.

Greptimedb MCP Server

greptimedb-mcp-server

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

28 13 tools GitHub PyPI

No known CVEs

No license

Actively maintained

Last commit 12d 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

80/100across 5 weighted dimensions

How we score →

0255075100

−20

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 actively maintained — last commit was 12 days ago. It has 28 GitHub stars.

Similar servers

Others in data / analytics

View all →

Dbhub96

Zero-dependency, token-efficient database MCP server for Postgres, MySQL, SQL Server, MariaDB, SQLite.

3.1k 2

Sink95

⚡ A Simple / Speedy / Secure Link Shortener with Analytics, 100% run on Cloudflare.

6.9k 3

Firecrawl Mcp Server95

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

6.7k 4

Supabase MCP Server95

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

2.8k 4

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`	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 per-partition scan metrics and index-pruning counters)
`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 Jinja templates for common tasks — pipeline_creator, log_pipeline, metrics_analysis, promql_analysis, trace_analysis, table_operation, schema_design_advisor, observability_correlation, ingestion_troubleshooting, query_performance_tuning

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
GREPTI

... [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

80/100across 5 weighted dimensions

How we score →

0255075100

−20

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 actively maintained — last commit was 12 days ago. It has 28 GitHub stars.