mcp-server-unitycatalog: Unity Catalog MCP 서버

개요

Unity Catalog 용 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 Unity Catalog 함수를 MCP 도구로 제공합니다.

도구

Unity Catalog에 등록된 모든 Unity Catalog 함수는 다음과 같은 사전 정의된 Unity Catalog AI 도구와 함께 사용할 수 있습니다.

1. uc_list_functions

   • 지정된 상위 카탈로그 및 스키마 내의 함수를 나열합니다.

   • 반환: Unity Catalog에서 검색된 함수 목록입니다.

2. uc_get_function

   • 부모 카탈로그 및 스키마 내에서 함수를 가져옵니다.

   • 입력:

     • name (문자열): 함수의 이름(완전히 정규화되지 않음).

   • 반환: Unity Catalog에서 검색된 함수 세부 정보입니다.

3. uc_create_function

   • 부모 카탈로그 및 스키마 내에 함수를 생성합니다. 경고: 이 API는 실험적이며 향후 버전에서 변경될 예정입니다 .

   • 입력:

     • name (문자열): 함수의 이름(완전히 정규화되지 않음).

     • script (문자열): 등록할 함수를 포함하는 Python 스크립트입니다.

   • 반환: Unity Catalog 내에서 생성된 함수 세부 정보입니다.

4. uc_delete_function

   • 부모 카탈로그 및 스키마 내의 함수를 삭제합니다.

   • 입력:

     • name (문자열): 함수의 이름(완전히 정규화되지 않음).

   • 반환: 없음.

Related MCP server: MCP Trino Server

설치

uv를 사용하여

uv 사용하면 별도의 설치가 필요하지 않습니다. uvx 사용하여 mcp-server-git을 직접 실행합니다.

구성

이러한 값은 CLI 옵션이나 .env 환경 변수를 통해서도 설정할 수 있습니다. 필수 인수는 Unity 카탈로그 서버, 카탈로그, 스키마이며, 액세스 토큰과 상세 수준은 선택 사항입니다. 더 자세한 구성 옵션을 보려면 uv run mcp-server-unitycatalog --help 실행하세요.

Claude Desktop 또는 VSCode Cline과 함께 사용

claude_desktop_config.json (또는 cline_mcp_settings.json )에 다음을 추가하세요.

지엑스피1

• 참고: '/Users/username'을 이 도구에서 액세스할 수 있도록 하려는 경로로 바꾸세요.

{
  "mcpServers": {
    "unitycatalog": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/unitycatalog",
        "--uc_server",
        "<your unity catalog url>",
        "--uc_catalog",
        "<your catalog name>",
        "--uc_schema",
        "<your schema name>"
      ]
    }
  }
}

건물

도커:

docker build -t mcp/unitycatalog .   

미래 계획

• [x] list_functions 에 대한 지원을 구현합니다.

• [x] get_function 에 대한 지원을 구현합니다.

• [x] create_python_function 에 대한 지원을 구현합니다.

• [x] execute_function 에 대한 지원을 구현합니다.

• [x] delete_function 에 대한 지원을 구현합니다.

• [ ] 의미 카탈로그 탐색기 도구를 구현합니다.

• [x] Docker 이미지를 추가합니다.

• [ ] use_xxx 메서드를 구현합니다. 현재 구현에서는 서버를 시작할 때 catalog 와 schema 정의해야 합니다. 하지만 use_catalog 및 use_schema 함수로 구현되어 use_xxx 실행될 때 사용 가능한 함수 목록이 동적으로 업데이트됩니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 약관에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.