mcp-server-unitycatalog: An Unity Catalog MCP server

mcp-server-unitycatalog：Unity Catalog MCP 服务

概述

一个适用于 Unity Catalog 的 Model Context Protocol 服务。此服务将 Unity Catalog Functions 作为 MCP 工具提供。

工具

除了以下预定义的 Unity Catalog AI 工具外，你还可以使用 在 Unity Catalog 中注册的所有 Unity Catalog Functions：

1. uc_list_functions

   • 列出指定父级目录和架构中的函数。
   • 返回：从 Unity Catalog 获取的函数列表。

2. uc_get_function

   • 获取父级目录和架构中的函数。
   • 输入：
     • name（string）：函数名称（非完全限定名称）。
   • 返回：从 Unity Catalog 获取的函数详情。

3. uc_create_function

   • 在父级目录和架构中创建函数。警告：此 API 处于实验阶段，未来版本中可能会更改。
   • 输入：
     • name（string）：函数名称（非完全限定名称）。
     • script（string）：包含要注册函数的 Python 脚本。
   • 返回：在 Unity Catalog 中创建的函数详情。

4. uc_delete_function

   • 删除父级目录和架构中的函数。
   • 输入：
     • name（string）：函数名称（非完全限定名称）。
   • 返回：无。

安装

使用 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>"
      ]
    }
  }
}

{
  "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 .   

未来计划

• 实现对 list_functions 的支持。
• 实现对 get_function 的支持。
• 实现对 create_python_function 的支持。
• 实现对 execute_function 的支持。
• 实现对 delete_function 的支持。
• 实现语义目录浏览工具。
• 添加 Docker 镜像。
• 实现 use_xxx 方法。在当前实现中，启动服务时需要定义 catalog 和 schema。不过，它们将作为 use_catalog 和 use_schema 函数实现，在执行 use_xxx 时动态更新可用函数列表。

许可证

此 MCP 服务采用 MIT License 授权。这意味着您可以自由使用、修改和分发此软件，但须遵守 MIT License 的条款和条件。详情请参阅项目仓库中的 LICENSE 文件。