Metabase

🚀 metabase-server MCP 服務器

metabase-server MCP 服務器是一個用於 Metabase 集成的 Model Context Protocol 服務器。它基於 TypeScript 構建，實現了與 Metabase API 的集成，能讓 AI 助手與 Metabase 交互，提供對儀表板、問題/卡片和數據庫等資源的訪問，以及列出和執行 Metabase 查詢等工具能力。

🚀 快速開始

metabase-server MCP 服務器是基於 TypeScript 的 MCP 服務器，實現了與 Metabase API 的集成，可讓 AI 助手與 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

您可以在 shell 配置文件中設置這些環境變量，或使用一個 package.json 文件配合 dotenv 包。

安裝依賴與構建

安裝依賴項：

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。