项目概述 dremio-local-mcp
这 dremio-local-mcp 是一个模型上下文协议(MCP)服务器,它将人工智能助手(如克劳德)连接到你的德雷米奥湖畔。
特性
- 语义层管理:直接从聊天中创建视图、更新wiki和标记数据集。
- 数据探索:列出数据集、检查模式和包上下文以进行分析。
- 查询执行:安全运行SQL查询(破坏性查询需要确认)。
- 工作分析:分析工作概况以提高绩效。
安装
pip install dremio-local-mcp配置
此工具使用标准的Dremio CLI配置格式。您可以使用管理您的Dremio凭据 德雷米奥 - CLI 实用程序(推荐)或通过YAML文件手动。
选项1:使用dremio-cli
首先,安装CLI(如果还没有):
pip install dremio-cli然后为您的环境创建一个配置文件:
对于Dremio Cloud:
# Create a profile named 'default'
dremio profile create --name default --type cloud --token --project-id --base-url https://api.dremio.cloud对于Dremio软件:
# Create a profile named 'software'
dremio profile create --name software --type software --base-url http://localhost:9047 --username --password
*(对于软件, verify_ssl 默认为 true.添加 --no-verify-ssl 如果使用自签名证书)*
选项2:手动YAML
创建或编辑 ~/.dremio/profiles.yaml 手动:
default_profile: cloud
profiles:
cloud:
base_url: "https://api.dremio.cloud"
token: "your-pat-token"
project_id: "your-project-id"
verify_ssl: true
software:
base_url: "http://localhost:9047"
username: "admin"
password: "password123"
verify_ssl: false
### Supported Authentication Flows
This MCP server supports all authentication flows available in `dremio-cli` (v1.10.0+):
1. **Cloud (PAT)**: Requires `token` and `project_id`.
2. **Software (PAT)**: Requires `token` and `base_url`.
3. **Software (User/Pass)**: Requires `username`, `password`, and `base_url`.
4. **Service (OAuth2 Credentials)**: Requires `client_id`, `client_secret`, and `base_url`.
> [!TIP]
> **Service/Credentials Flow**: If you are using the Client Credentials flow (common for service accounts), it is recommended to explicitly set the scope in your profile to ensure full access.
>
> ```yaml
> service_profile:
> type: "software" # or "cloud"
> base_url: "https://dremio.org/api/v3"
> auth:
> type: "oauth"
> client_id: "your-client-id"
> client_secret: "your-client-secret"
> # scope: "dremio.all" # NOTE: dremio-cli v1.11.0 currently ignores this key and defaults to dremio.all on retry
> ```用法
启动服务器
dremio-local-mcp start --profile default连通性测试
dremio-local-mcp test --profile defaultClaude桌面配置
生成配置块:
dremio-local-mcp config --profile default将输出复制到您的 claude_desktop_config.json.
