Metabase MCP

🚀 Metabase MCP 服務器

Metabase MCP 服務器是一個模型上下文協議（Model Context Protocol）服務器，它能將 AI 助手與 Metabase 分析平臺集成在一起，讓 AI 助手可以直接與分析數據交互。

🚀 快速開始

Metabase MCP 服務器提供與 Metabase API 的集成，讓具備 MCP 功能的大語言模型（LLM）能夠直接與分析數據進行交互，在分析平臺和對話式 AI 之間搭建起溝通的橋樑。

✨ 主要特性

• 資源訪問：通過直觀的 metabase:// URI 導航 Metabase 資源。
• 兩種身份驗證方法：支持基於會話和 API 密鑰的身份驗證。
• 結構化數據訪問：以 JSON 格式返回數據，方便 AI 助手使用。
• 全面日誌記錄：詳細記錄日誌，便於調試和監控。
• 錯誤處理：具備強大的錯誤處理能力，會給出清晰的錯誤消息。

📦 安裝指南

克隆倉庫

git clone git@github.com:hyeongjun-dev/metabase-mcp.git
cd metabase-mcp

安裝依賴項

npm install

運行開發服務器

npm run dev

Docker 部署

構建 Docker 映像

docker build -t metabase-mcp .

運行容器

docker run -e METABASE_URL=https://your-metabase.com -e METABASE_API_KEY=your_api_key metabase-mcp

💻 使用示例

可用工具

該服務器為 AI 助手公開了以下工具：

數據訪問工具

• list_dashboards：檢索 Metabase 實例中的所有可用儀表板。
• list_cards：獲取 Metabase 中的所有保存的問題/卡片。
• list_databases：查看所有連接的數據庫源。
• list_collections：列出 Metabase 中的所有集合。
• list_table_columns：列出指定表的列。

儀表板操作工具

• execute_card：執行指定的卡片並返回結果。
• get_card_result：獲取指定卡片的最新結果。
• get_result_preview：獲取指定結果的預覽。
• download_result：下載指定結果的文件。
• watch_cards：訂閱對多個卡片的關注，以在發生變化時接收更新。

集合操作工具

• list_collection_objects：列出集合中的所有對象（儀表板、卡片等）。
• get_collection_object：獲取集合中的特定對象。

📚 詳細文檔

配置

要配置 Metabase MCP 服務器，請設置以下環境變量：

基於 API 密鑰的身份驗證

METABASE_URL=https://your-metabase.com
METABASE_API_KEY=your_api_key

基於用戶名和密碼的身份驗證

METABASE_URL=https://your-metabase.com
METABASE_USER_EMAIL=your_email@example.com
METABASE_PASSWORD=your_password

安全注意事項

• 建議在生產環境中使用 API 密鑰身份驗證。
• 保持您的 API 密鑰和憑據安全。
• 考慮使用 Docker 密鑰或環境變量而不是硬編碼憑據。
• 應用適當網絡安全措施以限制對 Metabase 實例的訪問。

📄 許可證

文檔中未提及許可證相關信息。

🤝 貢獻

歡迎貢獻！請隨時提交拉取請求。