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

승인

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

감사해요!

Install Server

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

execute_sql

GreptimeDB MCP Server