mcp-server-unitycatalog: Unity Catalog MCP サーバー

概要

Unity Catalog用のモデルコンテキストプロトコルサーバー。このサーバーは、Unity Catalog 機能をMCP ツールとして提供します。

ツール

**Unity カタログに登録されているすべての Unity カタログ関数を、**次の定義済み Unity カタログ AI ツールと一緒に使用できます。

uc_list_functions
- 指定された親カタログとスキーマ内の関数を一覧表示します。
- 戻り値: Unity カタログから取得された関数のリスト。
uc_get_function
- 親カタログとスキーマ内の関数を取得します。
- 入力：
  - name (文字列): 関数の名前 (完全修飾名ではありません)。
- 戻り値: Unity カタログから取得された関数の詳細。
uc_create_function
- 親カタログとスキーマ内に関数を作成します。警告: この API は実験的なものであり、将来のバージョンで変更される予定です。
- 入力：
  - name (文字列): 関数の名前 (完全修飾名ではありません)。
  - script (文字列): 登録する関数を含む Python スクリプト。
- 戻り値: Unity カタログ内で作成された関数の詳細。
uc_delete_function
- 親カタログとスキーマ内の関数を削除します。
- 入力：
  - name (文字列): 関数の名前 (完全修飾名ではありません)。
- 戻り値: なし。

インストール

UVの使用

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

構成

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

口論	環境変数	説明	必須/オプション
`-u` , `--uc_server`	`UC_SERVER`	Unity カタログサーバーのベース 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 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ファイルをご覧ください。

Integrations