Metabase

🚀 metabase-server MCP サーバー

Metabase 統合用の Model Context Protocol サーバーです。

このサーバーは TypeScript ベースの MCP サーバーで、Metabase API との統合を実現しています。AI アシスタントが Metabase とやり取りできるようにし、以下の内容へのアクセスを提供します。

• リソースとしてのダッシュボード、質問/カード、データベース
• Metabase クエリの一覧表示と実行ツール
• Metabase データの表示と対話的なアクセス機能

✨ 主な機能

リソース

• metabase:// URI を通じて Metabase リソースを一覧表示し、アクセスすることができます。
• ダッシュボード、カード/質問、データベースにアクセスできます。
• 構造化データへのアクセスには JSON コンテンツタイプを使用します。

ツール

• list_dashboards - Metabase 内のすべてのダッシュボードを一覧表示します。
• list_cards - Metabase 内のすべてのカード/質問を一覧表示します。
• list_databases - Metabase 内のすべてのデータベースを一覧表示します。
• execute_card - Metabase の質問/カードを実行し、結果を取得します。
• get_dashboard_cards - ダッシュボード内のすべてのカードを取得します。
• execute_query - Metabase データベースに対して SQL クエリを実行します。

📦 インストール

環境変数の設定

サーバーを実行する前に、以下の環境変数を設定する必要があります。

# 必要な環境変数
export METABASE_URL=https://your-metabase-instance.com
export METABASE_USERNAME=your_username
export METABASE_PASSWORD=your_password

これらの環境変数は、シェルの設定ファイルに設定するか、package.json ファイルと dotenv パッケージを使用して設定できます。

Claude Desktop との連携

Claude Desktop で使用する場合は、サーバー設定を追加します。

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "metabase-server": {
      "command": "/path/to/metabase-server/build/index.js",
      "env": {
        "METABASE_URL": "https://your-metabase-instance.com",
        "METABASE_USERNAME": "your_username",
        "METABASE_PASSWORD": "your_password"
      }
    }
  }
}

注意: これらの変数は、設定ファイルではなくシステム環境変数を通じて設定することもできます。

Smithery を使用したインストール

Smithery を通じて metabase-server を自動インストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @imlewc/metabase-server --client claude

💻 使用例

基本的な使用法

サーバーを使用する前に、必要な依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

自動再構築を伴う開発モードで実行します。

npm run watch

高度な使用法

MCP サーバーは標準入出力を通じて通信するため、デバッグが難しい場合があります。MCP Inspector を使用することをおすすめします。これはパッケージスクリプトとして提供されています。

npm run inspector

Inspector は、ブラウザでアクセスできるデバッグツールの URL を提供します。