greptimeteam/greptimedb-mcp-server

Analytics & monitoring

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

29 stars 12 forks 품질 83 트렌드 39MIT

Repository Install

GreptimeDB를 위한 모형 Context 의정서 (MCP) 서버

개요

GreptimeDB의 모델 Context Protocol (MCP) 서버 - 한 엔진에서 미터, 로그 및 추적을 처리하는 오픈 소스 Observability 데이터베이스. SQL, TQL (PromQL 호환), RANGE 쿼리 및 분석 GreptimeDB를 쿼리하고 분석 할 수있는 AI 조수, 읽기 전용 시행 및 데이터 마스킹과 같은 내장 보안 기능. Claude 데스크톱의 경우 구성(~/Library/Application Support/Claude/claude desktop config.json)에 추가하십시오. search table semantics and semantic metadata in description table 읽기 information schema.table semantics. 테이블은 greptime을 운반 할 때 나타납니다. semantic.* 옵션 또는 내장 컨벤션은 그것을 위해 엔티티티티 선언을 파생합니다. 다른 테이블은 absent입니다. 서버는 한 번의 보기의 열 목록을 읽었고 열만 열만 노출합니다. entity declarations는 GreptimeDB 1.3을 요구합니다. 이전 버전에서는 빈 선언 세트와 같이 누락된 열으로 보고됩니다.

개요(AI 번역)

GreptimeDB의 모델 Context Protocol (MCP) 서버 - 한 엔진에서 미터, 로그 및 추적을 처리하는 오픈 소스 Observability 데이터베이스.

SQL, TQL (PromQL 호환), RANGE 쿼리 및 분석 GreptimeDB를 쿼리하고 분석 할 수있는 AI 조수, 읽기 전용 시행 및 데이터 마스킹과 같은 내장 보안 기능.

빠른 시작

Claude 데스크톱의 경우, macOS에서 config(~/Library/Application Support/Claude/claude_desktop_config.json]]에 추가하십시오.

특징

도구

도구	설명
`execute_sql`	형식의 SQL 쿼리 실행(csv/json/markdown) 및 제한 옵션
`execute_tql`	TQL(PromQL-compatible) 쿼리를 시간 시리즈 분석
`query_range`	RANGE/ALIGN 구문을 가진 시간 창 집계 쿼리 실시
`search_table_semantics`	일치한 조건에 따라 관찰 가능한 개념으로 테이블을 찾습니다. 테이블 이름, semantic 옵션 및 단체 선언을 검색합니다. `schema`
`query_semantic_graph`	Query the semantic graph: `summary`], `entities`, `relationships`, [`relationships`] (edges) over a required time window

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

greptimedb-mcp-server

A Model Context Protocol (MCP) server for GreptimeDB — an open-source observability database that handles metrics, logs, and traces in one engine.

Enables AI assistants to query and analyze GreptimeDB using SQL, TQL (PromQL-compatible), and RANGE queries, with built-in security features like read-only enforcement and data masking.

Quick Start

# Install
pip install greptimedb-mcp-server

# Run (connects to localhost:4002 by default)
greptimedb-mcp-server --host localhost --database public

For Claude Desktop, add this to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "greptimedb": {
      "command": "greptimedb-mcp-server",
      "args": ["--host", "localhost", "--database", "public"]
    }
  }
}

Features

Tools

Tool	Description
`execute_sql`	Execute SQL queries with format (csv/json/markdown) and limit options
`execute_tql`	Execute TQL (PromQL-compatible) queries for time-series analysis
`query_range`	Execute time-window aggregation queries with RANGE/ALIGN syntax
`search_table_semantics`	Find tables by observability concept, ranked by matched terms; searches table names, semantic options, and entity declarations. `schema` selects the database to search
`query_semantic_graph`	Query the semantic graph: `summary` (what it contains), `entities` (nodes), `relationships` (edges) over a required time window
`describe_table`	Inspect a table profile: schema, semantic metadata, latest sample rows, and query guidance
`explain_query`	Analyze SQL or TQL query execution plans (`analyze=true` for runtime stats; add `verbose=true` alongside `analyze=true` for per-partition scan metrics and index-pruning counters)
`health_check`	Check database connection status and server version

search_table_semantics and the semantic metadata in describe_table read information_schema.table_semantics. A table appears there when it carries a greptime.semantic.* option or a built-in convention derives an entity declaration for it; other tables are absent. The server reads the view’s column list once per process and selects only the columns it exposes. entity_declarations requires GreptimeDB 1.3; on earlier versions it is reported as a missing column rather than as an empty declaration set.

GitHub에서 전체 README 보기

설치

npx @modelcontextprotocol/inspector uv --directory . run -m greptimedb_mcp_server.server

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "greptimedb": {
      "command": "greptimedb-mcp-server",
      "args": ["--host", "localhost", "--database", "public"]
    }
  }
}