LogoFindMcp
Logo of greptimedb-mcp-server

greptimedb-mcp-server

A Model Context Protocol (MCP) server for GreptimeDB, enabling secure AI-driven database exploration and analysis.

Introduction

greptimedb-mcp-server

A Model Context Protocol (MCP) server implementation for GreptimeDB.

This server provides AI assistants with a secure and structured way to explore and analyze databases. It enables them to list tables, read data, and execute SQL queries through a controlled interface, ensuring responsible database access.

Capabilities
  • list_resources to list tables
  • read_resource to read table data
  • list_tools to list tools
  • call_tool to execute an SQL
  • list_prompts to list prompts
  • get_prompt to get the prompt by name
Usage

Configure the MCP server in Claude Desktop's configuration file:

MacOS

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Location: %APPDATA%/Claude/claude_desktop_config.json

Development
# Clone the repository
git clone https://github.com/GreptimeTeam/greptimedb-mcp-server.git
cd greptimedb-mcp-server
 
# Create virtual environment
uv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows
 
# Install development dependencies
uv sync
 
# Run tests
pytest

Use MCP Inspector for debugging:

npx @modelcontextprotocol/inspector uv \
  --directory \
  /path/to/greptimedb-mcp-server \
  run \
  -m \
  greptimedb_mcp_server.server

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates