greptimedb-mcp-server

👁 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: SQLite MCP Server

필수 조건

• 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

승인

이 라이브러리의 구현은 다음 두 저장소에서 영감을 얻었으며 해당 코드를 통합했습니다. 이에 대해 감사드립니다.

• ktanaka101/mcp-server-duckdb

• 디자인컴퓨터/mysql_mcp_server

• mikeskarl/mcp-프롬프트-템플릿

감사해요!

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create_dashboardC
• create_pipelineC
• delete_dashboardC
• delete_pipelineB
• describe_tableA
• dryrun_pipelineA
• execute_sqlA
• execute_tqlC