mcp-hydrolix

Hydrolix MCP 서버

Hydrolix용 MCP 서버.

도구

• run_select_query
  • Hydrolix 클러스터에서 SQL 쿼리를 실행합니다.
  • 입력: sql (문자열): 실행할 SQL 쿼리.
  • 모든 Hydrolix 쿼리는 안전을 보장하기 위해 readonly = 1 로 실행됩니다.
• list_databases
  • Hydrolix 클러스터에 있는 모든 데이터베이스를 나열합니다.
• list_tables
  • 데이터베이스의 모든 테이블을 나열합니다.
  • 입력: database (문자열): 데이터베이스의 이름입니다.

효과적인 사용법

LLM 아키텍처가 매우 다양하기 때문에 모든 모델이 위의 도구를 적극적으로 사용하는 것은 아니며, 모델에 제공된 도구에 대한 세심하게 구성된 설명이 있더라도 지침 없이 도구를 효과적으로 사용하는 모델은 거의 없습니다. Hydrolix MCP 서버를 사용하여 모델에서 최상의 결과를 얻으려면 다음을 권장합니다.

• 프롬프트에서 Hydrolix 데이터베이스를 이름으로 참조하고 도구 사용을 요청합니다(예: "MCP 도구를 사용하여 Hydrolix 데이터베이스에 액세스해 주세요...").
  • 이를 통해 모델은 사용 가능한 MCP 도구를 사용하고 환각을 최소화할 수 있습니다.
• 프롬프트에 시간 범위를 포함합니다(예: "2023년 12월 5일과 2024년 1월 18일 사이, ..."). 그리고 출력을 타임스탬프순으로 정렬해 달라고 구체적으로 요청합니다.
  • 이는 모델이 기본 키 최적화를 활용하는 보다 효율적인 쿼리를 작성하도록 합니다.

구성

Hydrolix MCP 서버는 표준 MCP 서버 항목을 사용하여 구성됩니다. MCP 서버를 찾거나 선언하는 방법에 대한 자세한 내용은 클라이언트 설명서를 참조하십시오. Claude Desktop을 사용한 설정 예시는 아래에 설명되어 있습니다.

Hydrolix MCP 서버를 시작하는 데 권장되는 방법은 uv 프로젝트 관리자를 통해 실행하는 것입니다. 이 관리자는 격리된 환경에서 다른 모든 종속성을 설치하는 작업을 관리합니다.

MCP 서버 정의(JSON):

지엑스피1

MCP 서버 정의(YAML):

구성 예(Claude Desktop)

1. 다음 위치에 있는 Claude Desktop 구성 파일을 엽니다.
   • macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json
2. mcpServers 구성 블록에 mcp-hydrolix 서버 항목을 추가합니다.

3. Hydrolix 클러스터를 가리키도록 환경 변수 정의를 업데이트합니다.
4. (권장) uv 명령 항목을 찾아 uv 실행 파일의 절대 경로로 바꾸세요. 이렇게 하면 서버를 시작할 때 올바른 버전의 uv 사용됩니다. which uv 또는 where.exe uv 사용하여 이 경로를 찾을 수 있습니다.
5. 변경 사항을 적용하려면 Claude Desktop을 다시 시작하세요. Windows를 사용하는 경우 시스템 트레이 아이콘을 사용하여 클라이언트를 닫아 Claude가 완전히 종료되었는지 확인하세요.

환경 변수

다음 변수는 Hydrolix 연결을 구성하는 데 사용됩니다. 이러한 변수는 MCP 구성 블록(위 참조), .env 파일 또는 기존 환경 변수를 통해 제공될 수 있습니다.

필수 변수

• HYDROLIX_HOST : Hydrolix 서버의 호스트 이름
• HYDROLIX_USER : 인증을 위한 사용자 이름
• HYDROLIX_PASSWORD : 인증을 위한 비밀번호

선택 변수

• HYDROLIX_PORT : Hydrolix 서버의 포트 번호
  • 기본값: 8088
  • 비표준 포트를 사용하지 않는 한 일반적으로 설정할 필요가 없습니다.
• HYDROLIX_VERIFY : SSL 인증서 검증을 활성화/비활성화합니다.
  • 기본값: "true"
  • 인증서 검증을 비활성화하려면 "false" 로 설정합니다(프로덕션에는 권장하지 않음).
• HYDROLIX_DATABASE : 사용할 기본 데이터베이스
  • 기본값: 없음(서버 기본값 사용)
  • 특정 데이터베이스에 자동으로 연결하려면 이것을 설정하세요.