greptimedb-mcp-server

Name: GreptimeDB MCP Server
Author: GreptimeTeam

PyPI - 버전 빌드 워크플로 MIT 라이센스

GreptimeDB 에 대한 MCP(Model Context Protocol) 서버 구현.

이 서버는 AI 비서에게 데이터베이스를 탐색하고 분석할 수 있는 안전하고 체계적인 방법을 제공합니다. AI 비서는 제어된 인터페이스를 통해 테이블 목록을 작성하고, 데이터를 읽고, SQL 쿼리를 실행하여 책임감 있는 데이터베이스 접근을 보장합니다.

프로젝트 상태

이 프로젝트는 아직 개발 중인 실험적 프로젝트입니다. 데이터 보안 및 개인정보 보호 문제는 아직 구체적으로 해결되지 않았으므로 주의해서 사용하시기 바랍니다.

역량

list_resources 사용하여 테이블 나열
테이블 데이터를 읽기 위한 read_resource
list_tools 로 도구 나열
SQL을 실행하기 위한 call_tool
list_prompts 로 프롬프트를 나열합니다
get_prompt 사용하여 이름으로 프롬프트를 가져옵니다.

설치

지엑스피1

구성

다음 환경 변수를 설정하세요.

GREPTIMEDB_HOST=localhost # Database host GREPTIMEDB_PORT=4002 # Optional: Database MySQL port (defaults to 4002 if not specified) GREPTIMEDB_USER=root GREPTIMEDB_PASSWORD= GREPTIMEDB_DATABASE=public

또는 명령줄 인수를 통해:

--host 데이터베이스 호스트(기본적으로 localhost
--port 데이터베이스 포트, MySQL 프로토콜 포트여야 함, 기본값은 4002 .
--user 데이터베이스 사용자 이름, 기본적으로 비어 있음
--password 데이터베이스 비밀번호, 기본적으로 비어 있음
--database 데이터베이스 이름, 기본적으로 public .

용법

Claude 데스크톱 통합

Claude Desktop의 구성 파일에서 MCP 서버를 구성합니다.

맥OS

위치: ~/Library/Application Support/Claude/claude_desktop_config.json

윈도우

위치: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "greptimedb": { "command": "uv", "args": [ "--directory", "/path/to/greptimedb-mcp-server", "run", "-m", "greptimedb_mcp_server.server" ], "env": { "GREPTIMEDB_HOST": "localhost", "GREPTIMEDB_PORT": "4002", "GREPTIMEDB_USER": "root", "GREPTIMEDB_PASSWORD": "", "GREPTIMEDB_DATABASE": "public" } } } }

특허

MIT 라이센스 - 자세한 내용은 LICENSE.md 파일을 참조하세요.

기여하다

Related MCP server: MCP Toolkit

필수 조건

uv 패키지 관리자를 사용한 Python
GreptimeDB 설치
MCP 서버 종속성

개발

# 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

디버깅을 위해 MCP Inspector를 사용하세요.

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