mcp-server-unitycatalog: An Unity Catalog MCP server

mcp-server-unitycatalog: An Unity Catalog MCP server

site icon
2025.03.29 12
Python数据库管理函数管理数据库
mcp-server-unitycatalog 是一个为 Unity Catalog 设计的 Model Context Protocol 服务器,提供 Unity Catalog Functions 作为 MCP 工具。该服务器支持列出、获取、创建和删除 Unity Catalog 中的函数,并计划未来支持更多功能如语义目录探索工具和动态更新可用函数列表。
View on GitHub

Overview

基本能力

产品定位

mcp-server-unitycatalog 是一个为 Unity Catalog 设计的 Model Context Protocol 服务器,旨在提供 Unity Catalog Functions 作为 MCP 工具,方便用户管理和操作 Unity Catalog 中的函数。

核心功能

  1. 列出函数uc_list_functions 工具可以列出指定父目录和模式中的函数。
  2. 获取函数uc_get_function 工具可以获取指定父目录和模式中的函数详细信息。
  3. 创建函数uc_create_function 工具可以在指定父目录和模式中创建新的函数(实验性功能)。
  4. 删除函数uc_delete_function 工具可以删除指定父目录和模式中的函数。

适用场景

  • 需要管理和操作 Unity Catalog 中的函数的开发者和数据工程师。
  • 需要在 Unity Catalog 中动态创建和删除函数的场景。
  • 需要集成 Unity Catalog Functions 到 MCP 工具链中的场景。

工具列表

  1. uc_list_functions:列出指定父目录和模式中的函数。
  2. uc_get_function:获取指定父目录和模式中的函数详细信息。
  3. uc_create_function:在指定父目录和模式中创建新的函数(实验性功能)。
  4. uc_delete_function:删除指定父目录和模式中的函数。

常见问题解答

  • 如何配置服务器?:可以通过 CLI 选项或 .env 环境变量配置 Unity Catalog 服务器、目录、模式、访问令牌和日志级别等参数。
  • 如何与 Claude Desktop 或 VSCode Cline 集成?:需要在配置文件中添加相应的命令和参数。

使用教程

使用依赖

无需特定安装,使用 uv 工具直接运行 mcp-server-unitycatalog

安装教程

  1. 使用 uvbash uv run mcp-server-unitycatalog --uc_server <your unity catalog url> --uc_catalog <your catalog name> --uc_schema <your schema name>
  2. 使用 Dockerbash docker build -t mcp/unitycatalog . docker run --rm -i mcp/unitycatalog --uc_server <your unity catalog url> --uc_catalog <your catalog name> --uc_schema <your schema name>

调试方式

运行服务器后,可以通过日志文件查看运行状态和调试信息。日志文件默认存储在 .mcp_server_unitycatalog 目录中。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。