Yes, Greptimedb is free to use.

How do I install Greptimedb?

Greptimedb is a local plugin. Install it using PyPI package: greptimedb-mcp-server and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Greptimedb need?

Greptimedb requires the following credentials or environment variables: GREPTIMEDB_HOST, GREPTIMEDB_PORT, GREPTIMEDB_USER, GREPTIMEDB_PASSWORD, GREPTIMEDB_DATABASE, GREPTIMEDB_TIMEZONE, GREPTIMEDB_POOL_SIZE, GREPTIMEDB_HTTP_PORT, GREPTIMEDB_HTTP_PROTOCOL, GREPTIMEDB_MASK_ENABLED, GREPTIMEDB_MASK_PATTERNS, GREPTIMEDB_AUDIT_ENABLED. You can find setup instructions on the server detail page.

What AI apps work with Greptimedb?

Greptimedb uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Greptimedb

by GreptimeTeam

Developer ToolsModerate5.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

What You'll Need

Set these up before or after installing:

GreptimeDB host addressOptional

Environment variable: GREPTIMEDB_HOST

GreptimeDB MySQL protocol port (default: 4002)Optional

Environment variable: GREPTIMEDB_PORT

Database usernameOptional

Environment variable: GREPTIMEDB_USER

Database passwordRequired

Environment variable: GREPTIMEDB_PASSWORD

Database name to connect toOptional

Environment variable: GREPTIMEDB_DATABASE

Session timezone (default: UTC)Optional

Environment variable: GREPTIMEDB_TIMEZONE

Connection pool size (default: 5)Optional

Environment variable: GREPTIMEDB_POOL_SIZE

HTTP API port for pipeline management (default: 4000)Optional

Environment variable: GREPTIMEDB_HTTP_PORT

HTTP protocol for pipeline API: http or https (default: http)Optional

Environment variable: GREPTIMEDB_HTTP_PROTOCOL

Enable sensitive data masking (default: true)Optional

Environment variable: GREPTIMEDB_MASK_ENABLED

Additional column name patterns for data masking (comma-separated)Optional

Environment variable: GREPTIMEDB_MASK_PATTERNS

Enable audit logging for tool invocations (default: true)Optional

Environment variable: GREPTIMEDB_AUDIT_ENABLED

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-greptimeteam-greptimedb-mcp-server": {
      "env": {
        "GREPTIMEDB_HOST": "your-greptimedb-host-here",
        "GREPTIMEDB_PORT": "your-greptimedb-port-here",
        "GREPTIMEDB_USER": "your-greptimedb-user-here",
        "GREPTIMEDB_DATABASE": "your-greptimedb-database-here",
        "GREPTIMEDB_PASSWORD": "your-greptimedb-password-here",
        "GREPTIMEDB_TIMEZONE": "your-greptimedb-timezone-here",
        "GREPTIMEDB_HTTP_PORT": "your-greptimedb-http-port-here",
        "GREPTIMEDB_POOL_SIZE": "your-greptimedb-pool-size-here",
        "GREPTIMEDB_MASK_ENABLED": "your-greptimedb-mask-enabled-here",
        "GREPTIMEDB_AUDIT_ENABLED": "your-greptimedb-audit-enabled-here",
        "GREPTIMEDB_HTTP_PROTOCOL": "your-greptimedb-http-protocol-here",
        "GREPTIMEDB_MASK_PATTERNS": "your-greptimedb-mask-patterns-here"
      },
      "args": [
        "greptimedb-mcp-server"
      ],
      "command": "uvx"
    }
  }
}

Security Report

5.2

Moderate5.2Moderate Risk

This is a well-architected GreptimeDB MCP server with strong security features including read-only enforcement, data masking, and audit logging. The code demonstrates good practices with proper authentication patterns, input validation, and SQL injection protection. Only minor quality improvements around error handling and validation coverage are needed. Supply chain analysis found 8 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

Scanned 4 files · 13 findings

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

database

Check that this permission is expected for this type of plugin.

Reviews

No reviews yet

Be the first to review this server!