Metabase MCP Server

Metabase MCP サーバー

このプロジェクトは、Metabase API と連携する MCP サーバーを実装し、主要な機能を MCP インターフェース経由で利用できるようにします。

機能

• 🔍 Metabase のカードを一覧表示
• 🗄️ 利用可能なデータベースを一覧表示
• 📊 カードのクエリを実行
• 🧾 任意のクエリを実行
• 📝 新しいカードを作成
• 🔖 ブックマークを作成
• 📁 コレクションを一覧表示

要件

• Python 3.12+
• uv

インストール

1. リポジトリをクローンします：

git clone https://github.com/cuenca-mx/metabase-mcp-server.git
cd metabase-mcp-server

2. 次の設定を追加して、AI アシスタントのクライアント（Claude、Cursor など）を設定します：

{
    "mcpServers": {
        "metabase": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/metabase_mcp_server",
                "run",
                "app.py"
            ],
            "env": {
                "METABASE_URL": "https://metabase.domain.com/",
                "METABASE_API_KEY": "your-secret-api-key"
            }
        }
    }
}

開発環境のセットアップ

このプロジェクトでは、開発タスクを簡単に実行できるように Makefile を使用しています：

make install

環境変数

必要な環境変数を設定します：

export $(<env.template)

テストの実行

このプロジェクトでは、ユニットテストに pytest を使用しています：

uv run pytest

MCP Inspector によるデバッグ

テストとデバッグには MCP Inspector を使用します：

make dev