Metabase MCP Server

🚀 metabase-server MCP 服務端

一個用於與 Metabase 集成的模型上下文協議（Model Context Protocol）服務器。該服務端基於 TypeScript 實現，支持與 Metabase API 集成，能讓 AI 助手訪問 Metabase 中的儀表板、問題/卡片和數據庫資源，還提供工具列出並執行 Metabase 查詢，以及查看和交互 Metabase 數據。

🚀 快速開始

metabase-server MCP 服務端是一個強大的工具，用於與 Metabase 集成，為 AI 助手提供對 Metabase 資源的訪問能力。以下是使用該服務端的基本步驟：

1. 按照配置部分的說明設置必要的環境變量。
2. 安裝依賴並構建服務端。
3. 根據需求選擇合適的安裝方式，如與 Claude Desktop 集成或通過 Smithery 安裝。

✨ 主要特性

資源

• 通過 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

你可以通過 shell 配置文件或使用 dotenv 包在 .env 文件中設置這些環境變量。

開發環境安裝

安裝依賴

npm install

構建服務端

npm run build

帶有自動重建功能的開發

npm run watch

與 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

調試

由於 MCP 服務器通過標準輸入/輸出進行通信，調試可能會比較困難。我們推薦使用 MCP Inspector，它作為一個包腳本可用：

npm run inspector

Inspector 將提供一個訪問瀏覽器調試工具的 URL。