Metabase MCPサーバー

AIアシスタントをMetabase分析プラットフォームと統合するModel Context Protocolサーバーです。

概要

このMCPサーバーはMetabase APIとの統合を提供し、MCP機能を持つLLMが分析データと直接やり取りできるようにします。このサーバーは、分析プラットフォームと会話型AIの間のブリッジとして機能します。

主な機能

• リソースアクセス: 直感的な metabase:// URIを使用してMetabaseリソースをナビゲート

• 2つの認証方法: セッションベースおよびAPIキー認証の両方をサポート

• 構造化データアクセス: AIアシスタントが容易に利用できるJSON形式のレスポンス

• 包括的なログ記録: デバッグと監視を容易にする詳細なログ記録

• エラーハンドリング: 明確なエラーメッセージによる堅牢なエラー処理

Related MCP server: Metabase MCP Server

利用可能なツール

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

データアクセスツール

• list_dashboards: Metabaseインスタンス内のすべての利用可能なダッシュボードを取得

• list_cards: Metabase内のすべての保存済み質問/カードを取得

• list_databases: すべての接続済みデータベースソースを表示

• list_collections: Metabase内のすべてのコレクションを一覧表示

• list_tables: 特定のデータベース内のすべてのテーブルを一覧表示

• get_table_fields: 特定のテーブル内のすべてのフィールド/カラムを取得

実行ツール

• execute_card: 保存された質問を実行し、オプションのパラメータを指定して結果を取得

• execute_query: 接続された任意のデータベースに対してカスタムSQLクエリを実行

ダッシュボード管理

• get_dashboard_cards: 特定のダッシュボードからすべてのカードを抽出

• create_dashboard: 指定された名前とパラメータで新しいダッシュボードを作成

• update_dashboard: 既存のダッシュボードの名前、説明、またはパラメータを更新

• delete_dashboard: ダッシュボードを削除

• add_card_to_dashboard: 位置指定およびオプションのタブ割り当てを使用して、ダッシュボードにカードを追加または更新

カード/質問管理

• create_card: SQLクエリを使用して新しい質問/カードを作成

• update_card_visualization: カードの可視化設定を更新

コレクション管理

• create_collection: ダッシュボードと質問を整理するための新しいコレクションを作成

設定

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

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

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

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

オプション2: APIキー認証（本番環境で推奨）

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

# Optional
LOG_LEVEL=info # Options: debug, info, warn, error, fatal

これらの環境変数を直接設定するか、dotenv を使用して .env ファイルを利用できます。

Smitheryを使用したデプロイ

このMCPサーバーをClaudeや他のAIアシスタントで使用するには、このリポジトリをフォークし、Smitheryを使用してデプロイしてください：

デプロイ手順:

1. このリポジトリを自分のGitHubアカウントにフォークする

2. Smithery にアクセスし、GitHubアカウントで接続する

3. Smitheryのインターフェースを通じてフォークしたリポジトリをデプロイする

Claude Desktopとの統合

Smitheryでホストされたバージョンを使用するようにClaude Desktopを設定します：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json を編集

Windows: %APPDATA%/Claude/claude_desktop_config.json を編集

APIキー認証:

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"your_api_key\",\"metabasePassword\":\"\",\"metabaseUserEmail\":\"\"}"
      ]
    }
  }
}

ユーザー名とパスワードによる認証:

{
  "mcpServers": {
    "metabase-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli@latest",
        "run",
        "YOUR_GITHUB_USERNAME/metabase-mcp-server",
        "--config",
        "{\"metabaseUrl\":\"https://your-metabase-instance.com\",\"metabaseApiKey\":\"\",\"metabasePassword\":\"your_password\",\"metabaseUserEmail\":\"your_email@example.com\"}"
      ]
    }
  }
}

セキュリティに関する考慮事項

• 本番環境ではAPIキー認証の使用を推奨します

• APIキーと認証情報は安全に保管してください

• 認証情報をハードコーディングする代わりに環境変数を使用することを検討してください

• Metabaseインスタンスへのアクセスを制限するために、適切なネットワークセキュリティ対策を適用してください

貢献

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