mcp-server-unitycatalog：Unity Catalog MCP 服务器

概述

Unity Catalog的模型上下文协议 (MCP) 服务器。该服务器提供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 Catalog 服务器、目录和架构，而访问令牌和详细程度是可选的。运行uv run mcp-server-unitycatalog --help获取更多详细的配置选项。

与 Claude Desktop 或 VSCode Cline 一起使用

将其添加到您的claude_desktop_config.json （或cline_mcp_settings.json ）：

{
  "mcpServers": {
    "unitycatalog": {
      "command": "uv",
      "args": [
        "--directory",
        "/<path to your local git repository>/mcp-server-unitycatalog",
        "run",
        "mcp-server-unitycatalog",
        "--uc_server",
        "<your unity catalog url>",
        "--uc_catalog",
        "<your catalog name>",
        "--uc_schema",
        "<your schema name>"
      ]
    }
  }
}

• 注意：将“/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：

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 文件。