mcp -unitycatalog

This MCP server exposes Unity Catalog functions as MCP tools. In addition to the Unity Catalog Functions registered in your Unity Catalog instance, you can access a set of predefined MCP tools such as uc_list_functions, uc_get_function, uc_create_function, and uc_delete_function. These tools let you list available functions, fetch details for a specific function, create a new Python-based function (note: this API is experimental), and delete existing functions within a parent catalog and schema. The server is designed to work with the Unity Catalog API, so you provide the Unity Catalog server URL, catalog, and schema, and optionally supply an access token and verbose logging level. Typical usage involves running the MCP server using uv (the Universal Verifier) or via a Docker image, then invoking the tools through your MCP client of choice.

Prerequisites:

• Install UV (and optionally UVX) per your environment documentation: https://docs.astral.sh/uv/
• Access to a Unity Catalog instance with a catalog and schema to target
• Network access from your environment to the Unity Catalog server

Installation steps:

1. Install UV and UVX (if you haven’t already).
   • macOS/Linux: curl -fsSL https://uv.sh/get | bash
   • Windows: follow the official UV installation instructions
2. Clone or obtain the mcp-server-unitycatalog repository locally.
3. Install any runtime dependencies if needed (usually handled by UV when launching the server).
4. Run the MCP server using UV with the proper configuration options (see the example below).

Environment variables:

• UC_SERVER: Unity Catalog base URL
• UC_CATALOG: Catalog name
• UC_SCHEMA: Schema name
• UC_TOKEN (optional): Access token for Unity Catalog API
• UC_VERBOSITY (optional): Logging level (default: warn)
• UC_LOG_DIRECTORY (optional): Directory for log files (default: .mcp_server_unitycatalog) Common issues:
• Ensure network access from the MCP host to the Unity Catalog server is allowed.
• If using Docker, make sure the image mcp/unitycatalog is accessible and the container can access your Unity Catalog endpoint.
• If uc_create_function is used, provide a valid Python script containing the function to register.

Configuration options can be overridden via CLI, environment variables, or .env files as supported by the UV-based launcher.