mcp-server-unitycatalog: An Unity Catalog MCP server

mcp-server-unitycatalog：Unity Catalog 用 MCP サーバー

概要

Unity Catalog 用の Model Context Protocol サーバーです。このサーバーは、Unity Catalog Functions を MCP ツールとして提供します。

ツール

以下の事前定義済み Unity Catalog AI ツールとともに、Unity Catalog に登録されているすべての Unity Catalog Functions を使用できます。

1. uc_list_functions

   • 指定した親カタログとスキーマ内の関数を一覧表示します。
   • 戻り値：Unity Catalog から取得した関数の一覧。

2. uc_get_function

   • 親カタログとスキーマ内の関数を取得します。
   • 入力：
     • name（文字列）：関数名（完全修飾名ではありません）。
   • 戻り値：Unity Catalog から取得した関数の詳細。

3. uc_create_function

   • 親カタログとスキーマ内に関数を作成します。警告：この API は試験的なものであり、今後のバージョンで変更されます。
   • 入力：
     • name（文字列）：関数名（完全修飾名ではありません）。
     • script（文字列）：登録する関数を含む Python スクリプト。
   • 戻り値：Unity Catalog 内に作成された関数の詳細。

4. uc_delete_function

   • 親カタログとスキーマ内の関数を削除します。
   • 入力：
     • name（文字列）：関数名（完全修飾名ではありません）。
   • 戻り値：なし。

インストール

uv を使用する

uv を使用する場合、特別なインストールは必要ありません。 uvx を使用して mcp-server-git を直接実行します。

設定

これらの値は CLI オプションまたは .env 環境変数でも設定できます。必須の引数は Unity Catalog サーバー、カタログ、スキーマです。アクセストークンと詳細度レベルは任意です。より詳しい設定オプションについては、uv run mcp-server-unitycatalog --help を実行してください。

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>"
      ]
    }
  }
}

{
  "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 .   

今後の予定

• list_functions のサポートを実装します。
• get_function のサポートを実装します。
• create_python_function のサポートを実装します。
• execute_function のサポートを実装します。
• delete_function のサポートを実装します。
• セマンティックカタログエクスプローラーのツールを実装します。
• Docker イメージを追加します。
• use_xxx メソッドを実装します。現在の実装では、サーバーの起動時に catalog と schema を定義する必要があります。ただし、これらは use_catalog と use_schema 関数として実装され、use_xxx を実行すると、利用可能な関数のリストが動的に更新されるようになります。

ライセンス

この MCP サーバーは MIT ライセンスのもとでライセンスされています。これは、MIT ライセンスの条項および条件に従う限り、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。