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

概述

Unity Catalog的模型上下文协议 (MCP) 服务器。该服务器提供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 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", "/<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时动态更新可用函数列表。