mcp-server-unitycatalog

by ognis1205
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables configuration through environment variables stored in .env files, making it easier to manage server settings.

  • Supports containerized deployment through Docker, allowing the MCP server to run in isolated environments with proper configuration.

  • Hosted on GitHub with documentation and resources available through the repository.

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 (문자열): 함수의 이름(완전히 정규화되지 않음).
    • 반환: 없음.

설치

uv를 사용하여

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

구성

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

논쟁환경 변수설명필수/선택
-u , --uc_serverUC_SERVERUnity Catalog 서버의 기본 URL입니다.필수의
-c , --uc_catalogUC_CATALOGUnity Catalog 카탈로그의 이름입니다.필수의
-s , --uc_schemaUC_SCHEMAUnity Catalog 카탈로그 내의 스키마 이름입니다.필수의
-t , --uc_tokenUC_TOKENUnity Catalog 서버에 대한 API 요청을 인증하는 데 사용되는 액세스 토큰입니다.선택 과목
-v , --uc_verbosityUC_VERBOSITY로깅에 대한 자세한 정보 표시 수준입니다. 기본값: warn .선택 과목
-l , --uc_log_directoryUC_LOG_DIRECTORY로그 파일이 저장될 디렉터리입니다. 기본값: .mcp_server_unitycatalog .선택 과목

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 메서드를 구현합니다. 현재 구현에서는 서버를 시작할 때 catalogschema 정의해야 합니다. 하지만 use_cataloguse_schema 함수로 구현되어 use_xxx 실행될 때 사용 가능한 함수 목록이 동적으로 업데이트됩니다.

특허

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

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

Unity Catalog 함수에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜 서버로, AI 어시스턴트가 표준화된 인터페이스를 통해 Unity Catalog 내의 함수를 직접 나열, 가져오기, 생성 및 삭제할 수 있도록 합니다.

  1. Overview
    1. Tools
  2. Installation
    1. Using uv
  3. Configuration
    1. Usage with Claude Desktop or VSCode Cline
  4. Building
    1. Future Plans
      1. License
        ID: rr69b233vd