mcp-server-unitycatalog: Unity Catalog MCP 서버

개요

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

도구

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

uc_list_functions
- 지정된 상위 카탈로그 및 스키마 내의 함수를 나열합니다.
- 반환: Unity Catalog에서 검색된 함수 목록입니다.
uc_get_function
- 부모 카탈로그 및 스키마 내에서 함수를 가져옵니다.
- 입력:
  - name (문자열): 함수의 이름(완전히 정규화되지 않음).
- 반환: Unity Catalog에서 검색된 함수 세부 정보입니다.
uc_create_function
- 부모 카탈로그 및 스키마 내에 함수를 생성합니다. 경고: 이 API는 실험적이며 향후 버전에서 변경될 예정입니다 .
- 입력:
  - name (문자열): 함수의 이름(완전히 정규화되지 않음).
  - script (문자열): 등록할 함수를 포함하는 Python 스크립트입니다.
- 반환: Unity Catalog 내에서 생성된 함수 세부 정보입니다.
uc_delete_function
- 부모 카탈로그 및 스키마 내의 함수를 삭제합니다.
- 입력:
  - name (문자열): 함수의 이름(완전히 정규화되지 않음).
- 반환: 없음.

Related MCP server: Directus MCP Server

설치

uv를 사용하여

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

구성

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

논쟁	환경 변수	설명	필수/선택
`-u` , `--uc_server`	`UC_SERVER`	Unity Catalog 서버의 기본 URL입니다.	필수의
`-c` , `--uc_catalog`	`UC_CATALOG`	Unity Catalog 카탈로그의 이름입니다.	필수의
`-s` , `--uc_schema`	`UC_SCHEMA`	Unity Catalog 카탈로그 내의 스키마 이름입니다.	필수의
`-t` , `--uc_token`	`UC_TOKEN`	Unity Catalog 서버에 대한 API 요청을 인증하는 데 사용되는 액세스 토큰입니다.	선택 과목
`-v` , `--uc_verbosity`	`UC_VERBOSITY`	로깅에 대한 자세한 정보 표시 수준입니다. 기본값: `warn` .	선택 과목
`-l` , `--uc_log_directory`	`UC_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 메서드를 구현합니다. 현재 구현에서는 서버를 시작할 때 catalog 와 schema 정의해야 합니다. 하지만 use_catalog 및 use_schema 함수로 구현되어 use_xxx 실행될 때 사용 가능한 함수 목록이 동적으로 업데이트됩니다.