Dremio MCP

🚀 Dremio 模型上下文協議（MCP）服務器文檔

Dremio MCP 服務器作為連接大型語言模型與 Dremio 數據湖分析平臺的橋樑，藉助 Model Context Protocol 讓 LLM 能夠訪問即時數據和元數據，極大地增強了分析能力。

🚀 快速開始

Dremio MCP 服務器是連接大型語言模型與 Dremio 數據湖分析平臺的關鍵橋樑，它能讓 LLM 通過特定協議訪問即時數據和元數據，提升分析能力。下面為你介紹如何快速搭建並使用該服務器。

📦 安裝指南

下載代碼

克隆倉庫到本地，並進入項目目錄：

git clone git@github.com:dremio/dremio-mcp.git
cd dremio-mcp

運行服務器

安裝依賴並啟動服務器：

npm install
uv run --directory . dremio-mcp-server

📚 詳細文檔

初始設置

MCP 服務器配置文件

MCP 服務器的配置文件默認位於 $HOME/.config/dremioai/config.yaml，你也可以通過 --config-file 參數來指定其他配置文件。

格式

# Dremio 配置：URI、PAT 和可選項目 ID
dremio:
    uri: https://... # Dremio URI
    pat: "@~/ws/tokens/idl.token" # PAT 可從文件加載，使用 @ 前綴
    # 項目 ID（僅在使用雲服務時）
    project_id: ...

# 工具模式：指定服務器運行的模式
tools:
    server_mode: FOR_DATA_PATTERNS # 默認模式，支持數據集分析

模式說明

• FOR_DATA_PATTERNS：允許 LLM 對數據表和數據進行分析，發現數據之間的關係。
• FOR_SELF：用於系統的自檢，例如工作負載分析等。
• FOR_PROMETHEUS：如果已經集成了 Prometheus，可增強監控能力。

多個模式之間可以使用逗號分隔。

LLM（Claude）配置文件

你需要編輯 Claude 的桌面配置文件：

• macOS 系統：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows 系統：%APPDATA%\Claude\claude_desktop_config.json

添加以下內容：

{
  "globalShortcut": "",
  "mcpServers": {
    "Dremio": {
      "command": "uv",
      "args": [
        "run",
        "--directory", "<頂層 Git 目錄>",
        "dremio-mcp-server",
        "run"
      ]
    }
  }
}

進一步文檔

• 架構：詳細概述了 MCP 服務器的架構，包括組件之間的交互和數據流。
• 工具：提供了全面的指南，涵蓋工具的分類與類型、使用示例以及開發規範。
• 設置：是完整的配置參考，包含 Dremio 連接參數、工具配置以及集成支持等內容。

📄 許可證

此倉庫旨在在開源環境下促進各方的貢獻，包括功能的添加、問題的報告和修復等。但需要注意的是，它並非 Dremio 產品的官方支持部分。

🤝 貢獻指南

如果你想為項目做出貢獻，請查閱 CONTRIBUTING.md，其中包含以下方面的內容：

• 開發環境的搭建方法。
• 如何進行貢獻。
• 編碼風格規範。
• 文檔要求。