MCP 服务器

mcp-server-unitycatalog

一个模型上下文协议（Model Context Protocol）服务器，提供对 Unity Catalog 函数的访问，允许 AI 助手通过一个标准化的接口直接在 Unity Catalog 中列出、获取、创建和删除函数。

README

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 (字符串): 函数的名称（非完全限定）。
- 返回：无。

安装

使用 uv

当使用 uv 时，无需进行特定的安装。我们将使用 uvx 直接运行 mcp-server-git。

配置

这些值也可以通过 CLI 选项或 .env 环境变量进行设置。必需的参数是 Unity Catalog 服务器、目录和模式，而访问令牌和详细程度级别是可选的。运行 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）中：

{
  "mcpServers": {
    "unitycatalog": {
      "command": "uv",
      "args": [
        "--directory",
        "/<指向您的本地 git 仓库的路径>/mcp-server-unitycatalog",
        "run",
        "mcp-server-unitycatalog",
        "--uc_server",
        "<您的 unity catalog url>",
        "--uc_catalog",
        "<您的目录名称>",
        "--uc_schema",
        "<您的模式名称>"
      ]
    }
  }
}

</details>

<details> <summary>使用 docker</summary>

注意：将 '/Users/username' 替换为您希望此工具可以访问的路径

{
  "mcpServers": {
    "unitycatalog": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/unitycatalog",
        "--uc_server",
        "<您的 unity catalog url>",
        "--uc_catalog",
        "<您的目录名称>",
        "--uc_schema",
        "<您的模式名称>"
      ]
    }
  }
}

</details>

构建

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 时动态更新可用函数列表。