🚀 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 了解开发环境搭建、如何进行贡献、编码风格规范以及文档要求等信息。