Metabase MCP

🚀 Metabase MCP サーバー

このサーバーは、モデルコンテキストプロトコル（Model Context Protocol）を用いて、AI アシスタントと Metabase 分析プラットフォームを統合するものです。

🚀 クイックスタート

この MCP サーバーは、Metabase API との統合を提供し、MCP 対応の大規模言語モデル（LLM）が分析データと直接やり取りできるようにします。これは、分析プラットフォームと対話型 AI の間の架け橋として機能します。

✨ 主な機能

• リソースアクセス：直感的な metabase:// URI を使って Metabase リソースをナビゲートできます。
• 2種類の認証方法：セッションベースと API キーベースの認証をサポートします。
• 構造化データアクセス：JSON 形式でデータを返し、AI アシスタントが消費しやすいようにします。
• 詳細なログ記録：デバッグとモニタリングに役立つ詳細なログを記録します。
• 強力なエラー処理：明確なエラーメッセージを伴う強力なエラー処理機能があります。

💻 使用例

このサーバーは、AI アシスタントに以下のツールを公開しています。

基本的な使用法

データアクセスツール

• list_dashboards：Metabase インスタンス内のすべての利用可能なダッシュボードを取得します。
• list_cards：Metabase 内のすべての保存された質問/カードを取得します。
• list_databases：すべての接続されたデータベースソースを表示します。
• list_collections：Metabase 内のすべてのコレクションをリストします。
• list_table_columns：指定されたテーブルの列をリストします。

ダッシュボード操作ツール

• execute_card：指定されたカードを実行し、結果を返します。
• get_card_result：指定されたカードの最新の結果を取得します。
• get_result_preview：指定された結果のプレビューを取得します。
• download_result：指定された結果をファイルとしてダウンロードします。
• watch_cards：複数のカードの変更をサブスクライブし、変更があったときに更新を受け取ります。

コレクション操作ツール

• list_collection_objects：コレクション内のすべてのオブジェクト（ダッシュボード、カードなど）をリストします。
• get_collection_object：コレクション内の特定のオブジェクトを取得します。

📦 インストール

Metabase MCP サーバーをインストールするには、以下の手順に従ってください。

リポジトリをクローンする

git clone git@github.com:hyeongjun-dev/metabase-mcp.git
cd metabase-mcp

依存関係をインストールする

npm install

開発サーバーを起動する

npm run dev

📚 ドキュメント

設定

Metabase MCP サーバーを設定するには、以下の環境変数を設定してください。

API キーベースの認証

METABASE_URL=https://your-metabase.com
METABASE_API_KEY=your_api_key

ユーザー名とパスワードベースの認証

METABASE_URL=https://your-metabase.com
METABASE_USER_EMAIL=your_email@example.com
METABASE_PASSWORD=your_password

Docker を使用したデプロイ

Metabase MCP サーバーを Docker でデプロイするには、以下のコマンドを実行してください。

Docker イメージをビルドする

docker build -t metabase-mcp .

コンテナを実行する

docker run -e METABASE_URL=https://your-metabase.com -e METABASE_API_KEY=your_api_key metabase-mcp

セキュリティに関する注意事項

• 本番環境では、API キーによる認証の使用をおすすめします。
• API キーと認証情報を安全に保管してください。
• Docker シークレットまたは環境変数を使用し、認証情報をハードコードしないでください。
• Metabase インスタンスへのアクセスを制限するために、適切なネットワークセキュリティ対策を適用してください。

🔧 技術詳細

このサーバーは、AI アシスタントが Metabase 分析プラットフォームとやり取りできるようにするためのモデルコンテキストプロトコル（MCP）を実装しています。サーバーは、Metabase API との統合を提供し、AI アシスタントがデータにアクセスし、操作できるようにします。

📄 ライセンス

原文書にライセンス情報が記載されていないため、このセクションは表示されません。

🔗 貢献

貢献を歓迎します！プルリクエストを送信してください。