Releases: GreptimeTeam/greptimedb-mcp-server
Releases · GreptimeTeam/greptimedb-mcp-server
v0.4.6
v0.4.4
v0.4.3
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
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
- Require
mcp >= 1.8.0forstreamable-httptransport.
Full Changelog: v0.4.0...v0.4.1
v0.4.0
Features
- HTTP transport modes (sse, streamable-http) for K8s/container deployments.
Requiresmcp>=1.8.0forstreamable-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
New Features
Pipeline Management Tools
create_pipeline- Create new pipelines with YAML configurationdryrun_pipeline- Test pipelines with sample data without writing to databasedelete_pipeline- Delete specific versions of a pipeline
Pipeline Creator Prompt Template
- New
pipeline_creatorprompt 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_PROTOCOLenvironment variable to configure HTTP/HTTPS protocol - Added
--http-protocolCLI argument (choices:http,https, default:http)
Bug Fixes
- Fixed
SHOW CREATE TABLEbeing blocked - Security gate now correctly allowsSHOW CREATE TABLEqueries 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_codeinstead ofstatus_code,timestampinstead ofts) and status code values (STATUS_CODE_ERRORinstead ofERROR) - table_operation: Fixed
REGION_STATISTICScolumn name (region_rowsinstead ofnum_rows),REGION_PEERSstatus value (ALIVEinstead ofREADY), and correctedSSTS_MANIFEST/SSTS_INDEX_META
query syntax
Other Improvements
- Reuse
aiohttp.ClientSessionfor 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
aiohttpfor async HTTP client support
Full Changelog: v0.3.0...v0.3.1
v0.3.0
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.
- Authentication:
- Configurable via
GREPTIMEDB_MASK_ENABLEDandGREPTIMEDB_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, andmarkdownoutput 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
What's Changed
- feat: supports time zone settings by @killme2008 in #16
- feat:
call_toolsupportsshow,tql_eval,desc tableandexplainetc. by @killme2008 #16 - feat: add more security checking by @killme2008 in #17
Full Changelog: v0.2.1...v0.2.2
v0.2.1
What's Changed
- fix: tempaltes directory not found after building by @killme2008 in #15
Full Changelog: v0.2.0...v0.2.1