Metabase MCP Server

🚀 Metabase MCP サーバー

このサーバーは、AI アシスタントと Metabase 分析プラットフォームを統合するためのモデルコンテキストプロトコル（Model Context Protocol）サーバーです。AI アシスタントが分析データと直接やり取りできるようになります。

🚀 クイックスタート

この TypeScript ベースの MCP サーバーは、Metabase API を統合することで、AI アシスタントが分析データと直接やり取りできるようにします。Claude や他の MCP 対応の AI アシスタント向けに設計されており、分析プラットフォームと対話型 AI の間の橋渡し役を果たします。

✨ 主な機能

• リソースアクセス：直感的な metabase:// URI を使用して Metabase リソースをナビゲートできます。
• 二重認証方法：セッションベースと API Key による認証をサポートしています。
• 構造化データアクセス：JSON 形式のレスポンスで、AI アシスタントが消費しやすいようになっています。
• 詳細なログ記録：デバッグや監視を容易にするための詳細なログ記録が行われます。
• エラー処理：強力なエラー処理と明確なエラーメッセージが提供されます。

📦 インストール

npm を使用してインストールします：

npm install metabase-mcp-server

💻 使用例

基本的な使用法

サーバーを起動するには、以下のコマンドを実行します：

node index.js

高度な使用法

以下は、コンフィグファイルの例です：

const config = {
  metabaseUrl: 'https://your-metabase-instance.com',
  apiKey: 'your_api_key_here',
  logLevel: 'info'
};

// サーバーの初期化
new MetabaseMCPServer(config);

📚 ドキュメント

利用可能なツール

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

• list_dashboards：Metabase インスタンス内のすべての利用可能なダッシュボードを取得します。
• list_cards：Metabase 内のすべての保存された質問/カードを取得します。
• list_databases：すべての接続されたデータベースソースを表示します。
• execute_card：保存された質問を実行し、結果を取得します。オプションのパラメータを指定できます。
• get_dashboard_cards：特定のダッシュボード内のすべてのカードを抽出します。
• execute_query：接続された任意のデータベースに対してカスタム SQL クエリを実行します。

設定

このサーバーは、2 つの認証方法をサポートしています：

オプション 1: ユーザー名とパスワードによる認証

# 必須設定
METABASE_URL=https://your-metabase-instance.com
METABASE_USER_EMAIL=your_email@example.com
METABASE_PASSWORD=your_password

# オプション設定
LOG_LEVEL=info # オプション: debug, info, warn, error, fatal

オプション 2: API Key による認証

# 必須設定
METABASE_URL=https://your-metabase-instance.com
METABASE_API_KEY=your_api_key_here

Docker サポート

コンテナ化されたデプロイのために Docker イメージが提供されています：

イメージのビルド

docker build -t metabase-mcp-server .

コンテナの実行

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

🔧 技術詳細

• このサーバーは、AI アシスタントと Metabase 分析プラットフォームを接続するためのモデルコンテキストプロトコル（MCP）を実装しています。
• TypeScript で開発されており、Metabase API を利用してデータにアクセスします。
• サポートされている認証方法には、セッションベースの認証と API Key による認証があります。
• ログ記録やエラー処理が強化されており、デバッグや監視が容易になっています。

📄 ライセンス

原文書にライセンス情報は記載されていません。

⚠️ 重要提示

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

💡 使用建议

このサーバーを使用する際には、以下の点に注意してください：

• コンフィグファイルや環境変数を適切に設定してください。
• 必要に応じてログレベルを調整し、デバッグや監視を行ってください。
• Docker を使用する場合は、イメージのビルドやコンテナの実行に関するコマンドを正しく実行してください。

作者: Hyeongjun Yu (@hyeongjun-dev)