Keboola MCP Server

🚀 Keboola MCP サーバーマニュアル

KeboolaのMCP（管理コンソール）サーバーは、Keboolaと接続してインタラクションするためのツールです。このサーバーを使用することで、データの管理や操作を効率的に行うことができます。

🚀 クイックスタート

Keboola MCPサーバーを使用するには、まずサーバーをインストールして構成する必要があります。その後、サーバーを起動して各種ツールを使用することができます。

✨ 主な機能

ストレージツール

• retrieve_buckets - プロジェクト内のすべてのストレージバケットを一覧表示します。
• get_bucket_detail - 特定のストレージバケットの詳細情報を取得します。
• retrieve_bucket_tables - 特定のストレージバケット内のすべてのテーブルを一覧表示します。
• get_table_detail - 特定のテーブルの詳細情報を取得します。
• update_bucket_description - ストレージバケットの説明を更新します。
• update_table_description - テーブルの説明を更新します。

SQLツール

• query_table - ワークスペース内でSQLクエリを実行します。
• get_sql_dialect - ワークスペースで使用されているSQL方言（SnowflakeまたはBigQuery）を取得します。

コンポーネントツール

• retrieve_components - すべての利用可能なコンポーネントとその構成を一覧表示します。
• retrieve_transformations - 変換構成を一覧表示します。
• get_component_details - 特定のコンポーネントの詳細情報を取得します。
• create_sql_transformation - 新しいSQL変換構成を作成します。

ジョブツール

• retrieve_jobs - プロジェクト内のすべてのジョブを一覧表示します。
• get_job_detail - 特定のジョブの詳細情報を取得します。
• start_job - 新しいコンポーネント構成のジョブを開始します。

ドキュメントツール

• docs_query - ドキュメントやヘルプ情報を検索します。

📦 インストール

MCPサーバーのインストール

1. Keboola MCPサーバーのコードリポジトリをローカルにクローンします。
2. 仮想環境をアクティブ化し、必要な依存関係をインストールします。

python -m pip install -r requirements.txt

MCPサーバーの構成

以下の環境変数を設定します。

• KBC_API_URL：Keboola APIのURL（例：https://connection.YOUR_REGION.keboola.com）
• KBC_STORAGE_TOKEN：あなたのストレージトークン
• KBC_WORKSPACE_SCHEMA：あなたのワークスペーススキーマ（SnowflakeまたはBigQuery）

💻 使用例

MCPサーバーの起動

python -m keboola_mcp_server.cli --transport <transport-type> --api-url https://connection.YOUR_REGION.keboola.com

サポートされているトランスポートタイプは以下の通りです。

• http：HTTPエンドポイントを介してアクセスします。
• stdio：標準入出力を介して対話します。
• sse：サーバー送信イベント（Server-Sent Events）を介して通信します。

MCPツールの使用

以下は、いくつかの一般的なツールの操作例です。

ストレージツールの例

# すべてのストレージバケットを取得する
python -m keboola_mcp_server.cli retrieve-buckets --transport stdio

# 特定のストレージバケットの詳細情報を取得する
python -m keboola_mcp_server.cli get-bucket-detail <bucket-id> --transport stdio

SQLツールの例

# SQLクエリを実行する
python -m keboola_mcp_server.cli query-table <table-id> "<your-sql-query>" --transport stdio

# SQL方言を取得する
python -m keboola_mcp_server.cli get-sql-dialect --transport stdio

コンポーネントツールの例

# すべてのコンポーネントを取得する
python -m keboola_mcp_server.cli retrieve-components --transport stdio

# 新しいSQL変換構成を作成する
python -m keboola_mcp_server.cli create-sql-transformation <component-id> "<transformation-query>" --transport stdio

📚 ドキュメント

注意事項

• 本番環境でMCPサーバーを使用する前に、すべての環境変数が正しく設定されていることを確認してください。
• 最新の機能とセキュリティパッチを取得するために、定期的に依存関係を更新してください。

開発とテスト

テストの実行

python -m pytest tests/

コードの提出

標準的なGitの流れに従ってコードを提出します。

1. 新しい機能を作成するか、問題を修正します。
2. 変更をローカルリポジトリにコミットします。
3. リモートリポジトリにプッシュし、Pull Requestを作成します。

トラブルシューティング

問題が発生した場合は、Keboolaドキュメントを参照するか、サポートチームに連絡してください。

以上の手順に従うことで、Keboola MCPサーバーをスムーズにインストール、構成、使用し、必要に応じて開発や拡張を行うことができます。