Skip to content

Releases: GreptimeTeam/greptimedb-mcp-server

v0.4.6

02 Feb 12:40
v0.4.6
02bc129

Choose a tag to compare

What's Changed

  • feat: allow inline pipeline in dryrun tool by @sunng87 in #34

Full Changelog: v0.4.4...v0.4.6

v0.4.4

19 Jan 08:49

Choose a tag to compare

  • Try to fix hang on windows platform 5dc1115

v0.4.3

19 Jan 08:19

Choose a tag to compare

What's Changed

  • ci: run on matrix.os by @killme2008 in #33
  • fix: unread result found while reusing connections

Full Changelog: v0.4.2...v0.4.3

v0.4.2

24 Dec 01:09
f60b305

Choose a tag to compare

What's Changed

  • feat: supports allowed_hosts/allowed_origins for DNS rebinding protections by @killme2008 in #32

Full Changelog: v0.4.1...v0.4.2

v0.4.1

11 Dec 00:28

Choose a tag to compare

  • Require mcp >= 1.8.0 for streamable-http transport.

Full Changelog: v0.4.0...v0.4.1

v0.4.0

10 Dec 14:19
df74731

Choose a tag to compare

Features

  • HTTP transport modes (sse, streamable-http) for K8s/container deployments.
    Requires mcp>=1.8.0 for streamable-http:
# Streamable HTTP (recommended for production)
greptimedb-mcp-server --transport streamable-http --listen-port 8080

# SSE mode (legacy)
greptimedb-mcp-server --transport sse --listen-port 3000
  • Audit logging for all tool invocations
  • Graceful shutdown on SIGINT/SIGTERM

Fixed

  • TQL start/end parameter format
  • SQL injection in TQL parameters

Docs

  • Restructured README, added Quick Start
  • Extracted LLM instructions to docs/llm-instructions.md

v0.3.1

01 Dec 18:46

Choose a tag to compare

New Features

Pipeline Management Tools

  • create_pipeline - Create new pipelines with YAML configuration
  • dryrun_pipeline - Test pipelines with sample data without writing to database
  • delete_pipeline - Delete specific versions of a pipeline

Pipeline Creator Prompt Template

  • New pipeline_creator prompt template to help LLMs generate GreptimeDB pipeline YAML configurations from log samples. E.g. https://claude.ai/share/4d2146b1-a308-4115-a5e2-c945b2d23b87
  • Includes comprehensive guidelines for:
    • Pipeline processors (dissect, regex, date, epoch, gsub, select)
    • Transform configuration and data types
    • Index selection best practices (inverted, fulltext, skipping)
    • Table design recommendations for log tables

HTTPS Support

  • Added GREPTIMEDB_HTTP_PROTOCOL environment variable to configure HTTP/HTTPS protocol
  • Added --http-protocol CLI argument (choices: http, https, default: http)

Bug Fixes

  • Fixed SHOW CREATE TABLE being blocked - Security gate now correctly allows SHOW CREATE TABLE queries by using start-of-line anchoring for DDL patterns
  • Fixed prompt template variable rendering - Template variables like {{ pipeline_name }} are now correctly substituted

Improvements

Prompt Templates Updated

All prompt templates now include a References section with links to official GreptimeDB documentation:

Template Documentation References
pipeline_creator Pipeline Config, Manage Pipelines, Data Index, Table Design, Logs Overview
log_pipeline Full-Text Search, Log Query, SQL SELECT, SQL Functions
metrics_analysis SQL Query, RANGE Query, SQL Functions, CTE, Data Model
promql_analysis TQL Reference, PromQL Guide, Time Durations
iot_monitoring Data Model, CREATE TABLE, RANGE Query, SQL Functions, Table Design
trace_analysis Traces Overview, Traces Data Model, Read/Write Traces, Jaeger Query, Approximate Functions
table_operation INFORMATION_SCHEMA, CLUSTER_INFO, REGION_PEERS, REGION_STATISTICS, EXPLAIN, SHOW

Template Accuracy Fixes

  • trace_analysis: Fixed column names (span_status_code instead of status_code, timestamp instead of ts) and status code values (STATUS_CODE_ERROR instead of ERROR)
  • table_operation: Fixed REGION_STATISTICS column name (region_rows instead of num_rows), REGION_PEERS status value (ALIVE instead of READY), and corrected SSTS_MANIFEST/SSTS_INDEX_META
    query syntax

Other Improvements

  • Reuse aiohttp.ClientSession for HTTP requests instead of creating new sessions per request
  • Added argument name validation for prompt templates (must be valid Python identifiers)
  • Improved README documentation with LLM instructions and usage examples

Dependencies

  • Added aiohttp for async HTTP client support

Full Changelog: v0.3.0...v0.3.1

v0.3.0

30 Nov 19:11

Choose a tag to compare

Release Notes v0.3.0

New Features

Data Masking

  • Automatic sensitive data masking for query results
  • Built-in patterns for:
    • Authentication: password, token, api_key, secret, credential, etc.
    • Financial: credit_card, cvv, bank_account, iban, etc.
    • Personal: ssn, passport, id_card, etc.
  • Configurable via GREPTIMEDB_MASK_ENABLED and GREPTIMEDB_MASK_PATTERNS
  • Masked values appear as ****** in all output formats

New Tools

Tool Description
execute_tql Execute TQL (PromQL-compatible) queries
query_range Execute RANGE/ALIGN aggregation queries
explain_query Analyze SQL or TQL query execution plans

New Prompt Templates

Template Description
iot_monitoring IoT device monitoring and analysis
log_pipeline Log data analysis with full-text search
trace_analysis Distributed tracing analysis
promql_analysis PromQL/TQL query guidance

Output Format Support

  • All query tools now support csv, json, and markdown output formats

Improvements

  • Migrated to FastMCP
  • Fixed CTE (Common Table Expression) query support in security gate
  • Enhanced security gate with better injection prevention
  • Improved prompt templates with correct GreptimeDB SQL syntax
  • Code refactoring: split formatter and masking into separate modules

Breaking Changes

None


Full Changelog: v0.2.2...v0.3.0

v0.2.2

09 Jun 02:49

Choose a tag to compare

What's Changed

Full Changelog: v0.2.1...v0.2.2

v0.2.1

27 May 03:01
22f621c

Choose a tag to compare

What's Changed

  • fix: tempaltes directory not found after building by @killme2008 in #15

Full Changelog: v0.2.0...v0.2.1