GreptimeDB MCP Server

Official

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

greptimedb-mcp-server

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 port (defaults to 4002 if not specified) GREPTIMEDB_USER=root GREPTIMEDB_PASSWORD= GREPTIMEDB_DATABASE=public

또는 명령줄 인수를 통해:

  • --host 데이터베이스 호스트
  • --port 데이터베이스 포트
  • --user 데이터베이스 사용자 이름
  • --password 데이터베이스 비밀번호
  • --database 데이터베이스 이름

용법

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 파일을 참조하세요.

기여하다

필수 조건

  • 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

승인

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

감사해요!

-
security - not tested
A
license - permissive license
-
quality - not tested

AI 어시스턴트가 GreptimeDB와 안전하게 상호작용할 수 있도록 하는 모델 컨텍스트 프로토콜 서버 구현으로, 제어된 인터페이스를 통해 데이터베이스 스키마를 탐색하고, 데이터를 읽고, SQL 쿼리를 실행할 수 있습니다.

  1. Capabilities
    1. Installation
      1. Configuration
        1. Usage
          1. Claude Desktop Integration
        2. License
          1. Contribute
            1. Prerequisites
            2. Development
          2. Acknowledgement
            ID: s7x4xtbklm