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 MCP Server

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.

4 files analyzed · 13 issues found

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!

More Developer Tools MCP Servers

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

mcp-creator-typescript

Free

by mcp-marketplace · Developer Tools

Scaffold, build, and publish TypeScript MCP servers to npm — conversationally

FinAgent

Free

by mcp-marketplace · Finance

Free stock data and market news for any MCP-compatible AI assistant.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Document Converter

Free

by xt765 · Developer Tools

Convert PDF, DOCX, HTML, Markdown, and Text for AI assistant context injection.

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

{ "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

4 files analyzed · 13 issues found

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.

Greptimedb MCP Server

About

What You'll Need

How to Install

Security Report

Permissions Required

Findings (13)

Reviews

No reviews yet

More Developer Tools MCP Servers

Toleno

mcp-creator-python

mcp-creator-typescript

FinAgent

MarkItDown

Document Converter

Greptimedb MCP Server

About

What You'll Need

How to Install

Security Report

Permissions Required

Findings (13)

Reviews

No reviews yet

More Developer Tools MCP Servers

Toleno

mcp-creator-python

mcp-creator-typescript

FinAgent

MarkItDown

Document Converter