Databricks MCP Server

🚀 Databricks MCP サーバー

Databricks とのやり取りを行うためのモデルコンテキストプロトコル (MCP) サーバーです。

🚀 クイックスタート

Databricks MCP サーバーを使用するには、以下の手順に従ってください。

1. システムに適したバージョンをダウンロードしてインストールします。
2. サーバーを起動します。
3. 提供されているツールを使用して、Databricks ワークスペースとのやり取りを行います。

✨ 主な機能

Databricks MCP サーバーは、Databricks ワークスペースとのやり取りを行うためのモデルコンテキストプロトコル (MCP) インターフェースを提供します。以下の機能があります。

• ディレクトリの一覧表示：Databricks ワークスペース内の利用可能なすべてのディレクトリを一覧表示します。
• スキーマの一覧表示：指定された Databricks ディレクトリ内のすべてのスキーマを一覧表示します。
• テーブルの一覧表示：指定された Databricks スキーマ内のすべてのテーブルを、オプションのフィルターを使用して一覧表示します。
• SQL の実行：Databricks SQL リポジトリ上で SQL ステートメントを実行し、結果を返します。

📦 インストール

以下の方法で、適切なバージョンの Databricks MCP サーバーをインストールできます。

• Releases ページから、自分のプラットフォームに適した最新バージョンをダウンロードします。
• VS Code：以下のリンクから、VS Code 内で Databricks MCP Server 拡張機能をインストールできます。 または、以下のコマンドを実行して手動で拡張機能をインストールできます。

# 通常の VS Code
code --add-mcp '{"name":"databricks","command":"npx","args":["databricks-mcp-server@latest"]}'
# VS Code Insiders
code-insiders --add-mcp '{"name":"databricks","command":"npx","args":["databricks-mcp-server@latest"]}'

サポートされるプラットフォーム

• Linux（amd64）
• Windows（amd64）
• macOS（amd64）

💻 使用例

基本的な使用法

ディレクトリの一覧表示

# サンプルコマンド
curl -X POST http://localhost:8080/mcp/list_catalogs

スキーマの一覧表示

# サンプルコマンド
curl -X POST http://localhost:8080/mcp/list_schemas?catalog=my_catalog

テーブルの一覧表示

# サンプルコマンド
curl -X POST http://localhost:8080/mcp/list_tables?catalog=my_catalog&schema=my_schema

📚 ドキュメント

ツールの詳細

ディレクトリの一覧表示

• ツール名：list_catalogs
• パラメータ：なし
• 戻り値：ディレクトリオブジェクトの JSON 配列

スキーマの一覧表示

• ツール名：list_schemas
• パラメータ：
  • catalog (文字列、必須)：スキーマを含むディレクトリの名前
• 戻り値：スキーマオブジェクトの JSON 配列

テーブルの一覧表示

• ツール名：list_tables
• パラメータ：
  • catalog (文字列、必須)：スキーマを含むディレクトリの名前
  • schema (文字列、必須)：テーブルを一覧表示するスキーマの名前
  • filter_pattern (文字列、オプション、デフォルト値: ".*")：テーブル名をフィルタリングするための正規表現パターン
• 戻り値：テーブルオブジェクトの JSON 配列

SQL の実行

• ツール名：execute_sql
• パラメータ：
  • statement (文字列、必須)：実行する SQL ステートメント
  • timeout_seconds (数値、オプション、デフォルト値: 60)：ステートメントの実行タイムアウト時間（秒）
  • row_limit (数値、オプション)：返される最大行数
• 戻り値：実行結果の JSON オブジェクト

⚠️ 重要提示

• サーバーが安全な環境で実行されていることを確認してください。
• アクセスを制限するために、適切なファイアウォールルールを設定してください。

これらのツールを使用することで、Databricks ワークスペースとのやり取りや、様々な操作を簡単に行うことができます。