Unity Catalog MCP服务器

一个为Unity Catalog提供的模型上下文协议服务器,支持列出、获取、创建和删除Unity Catalog函数。

  • by ognis1205
  • Python
  • 本地部署
  • 15 星标
  • 更新于
在 GitHub 查看 ognis1205/mcp-server-unitycatalog

使用说明

mcp服务器unitycatalog:Unity目录mcp服务器

概述

一个模型上下文协议服务器 Unity目录。此服务器提供 Unity目录功能 作为MCP工具。

工具

您可以使用 Unity目录中注册的所有Unity目录函数 以及以下预定义的Unity Catalog AI工具:

  1. uc_list_functions

    • 列出指定父目录和架构中的函数。
    • 返回:从Unity目录检索到的函数列表。
  2. uc_get_function

    • 获取父目录和架构中的函数。
    • 输入:
      • name (string):函数的名称(未完全限定)。
    • 返回:从Unity目录检索到的函数详细信息。
  3. uc_create_function

    • 在父目录和架构中创建函数。 警告:此API是实验性的,将在未来版本中更改.
    • 输入:
      • name (string):函数的名称(未完全限定)。
      • script (string):包含要注册的函数的Python脚本。
    • 返回:在Unity Catalog中创建的函数详细信息。
  4. uc_delete_function

    • 删除父目录和架构中的函数。
    • 输入:
      • name (string):函数的名称(未完全限定)。
    • 返回:无。

安装

使用紫外线

使用时 uv 不需要特定的安装。我们将使用 uvx 直接运行 mcp服务器git.

配置

这些值也可以通过CLI选项或 .env 环境变量。必需的参数是Unity Catalog服务器、目录和模式,而访问令牌和详细级别是可选的。跑 uv run mcp-server-unitycatalog --help 有关更详细的配置选项。

参数 环境变量 描述 必填/可选
-u, --uc_server UC_SERVER Unity目录服务器的基本URL。 必填
-c, --uc_catalog UC_CATALOG Unity目录的名称。 必填
-s, --uc_schema UC_SCHEMA Unity目录目录中的模式名称。 必填
-t, --uc_token UC_TOKEN 用于向Unity目录服务器授权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):

Using uv
{
  "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>"
      ]
    }
  }
}
Using docker
  • 注意:将“/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文件。