Metabase MCP Server

🚀 metabase-server MCP サーバー

このサーバーは、Metabase と統合するためのモデルコンテキストプロトコル（Model Context Protocol、MCP）を提供します。TypeScript で実装され、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

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

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 を提供します。