mcp-server-unitycatalog: An Unity Catalog MCP server

Overview

A Model Context Protocol server for Unity Catalog. This server provides Unity Catalog Functions as MCP tools.

Tools

You can use all Unity Catalog Functions registered in Unity Catalog alongside the following predefined Unity Catalog AI tools:

1. uc_list_functions - Lists functions within the specified parent catalog and schema.
2. uc_get_function - Gets a function within a parent catalog and schema.
3. uc_create_function - Creates a function within a parent catalog and schema. WARNING: This API is experimental and will change in future versions.
4. uc_delete_function - Deletes a function within a parent catalog and schema.

Installation# Using uv

When using uv no specific installation is needed. We will use uvx to directly run mcp-server-git.

Configuration

These values can also be set via CLI options or .env environment variables. Required arguments are the Unity Catalog server, catalog, and schema, while the access token and verbosity level are optional. Run uv run mcp-server-unitycatalog --help for more detailed configuration options.

Usage with Claude Desktop or VSCode

Add this to your claude_desktop_config.json (or cline_mcp_settings.json): Using uv

{
  "mcpServers": {
    "unitycatalog": {
      "command": "uv",
      "args": [
        "--directory",
        "//mcp-server-unitycatalog",
        "run",
        "mcp-server-unitycatalog",
        "--uc_server",
        "",
        "--uc_catalog",
        "",
        "--uc_schema",
        ""
      ]
    }
  }
}

Using docker

• Note: replace '/Users/username' with the a path that you want to be accessible by this tool

{
  "mcpServers": {
    "unitycatalog": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp/unitycatalog",
        "--uc_server",
        "",
        "--uc_catalog",
        "",
        "--uc_schema",
        ""
      ]
    }
  }
}

Building Docker:

docker build -t mcp/unitycatalog .

Future Plans

• Implement support for list_functions.
• Implement support for get_function.
• Implement support for create_python_function.
• Implement support for execute_function.
• Implement support for delete_function.
• Implement semantic catalog explorer tools.
• Add Docker image.
• Implement use_xxx methods.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.