GreptimeDB

GreptimeDB

Provides AI assistants with a secure and structured way to explore and analyze data in GreptimeDB.

23
Stars
12
Forks
3
Releases

Overview

greptimedb-mcp-server is an MCP server implementation for GreptimeDB that enables AI assistants to securely and structurally explore and analyze databases. It exposes MCP capabilities to interact with a GreptimeDB instance, including listing resources (tables), reading resource data, listing and using tools, and executing SQL via a controlled interface. Supported operations include list_resources to enumerate tables, read_resource to fetch table data, list_tools to discover available tools, call_tool to run SQL, and prompts-related operations (list_prompts, get_prompt) to tailor agent behavior. The project is described as experimental and under active development; data security and privacy considerations are not specifically addressed in the README, so users should exercise caution. Configuration supports connecting to GreptimeDB via environment variables (GREPTIMEDB_HOST, GREPTIMEDB_PORT with a default of 4002 for MySQL protocol, GREPTIMEDB_USER, GREPTIMEDB_PASSWORD, GREPTIMEDB_DATABASE, GREPTIMEDB_TIMEZONE) or CLI arguments. The server can be integrated with Claude Desktop by adding an MCP server entry that invokes uv to run the greptimedb_mcp_server.server module. The project is MIT licensed and provides development guidance, including installation steps, testing, and debugging tools like MCP Inspector.

Details

Owner
GreptimeTeam
Language
Python
License
MIT License
Updated
2025-12-07

Features

list_resources

List tables/resources in the connected GreptimeDB instance.

read_resource

Read data from a specified table/resource.

list_tools

List available tools that can be used within the MCP context.

call_tool

Execute an SQL command via a tool to query or mutate data.

list_prompts

List prompts available to guide AI assistants.

get_prompt

Retrieve a specific prompt by name for assistant usage.

Audience

AI assistantsQuery tables, read data, and run SQL via MCP interface.
Developers/Data scientistsIntegrate MCP server to enable structured data access within applications.
AdministratorsMonitor and manage controlled database access for AI-powered tools.

Tags

GreptimeDBMCPAIdatabaseSQLMySQLdata-explorationClaude-Desktop