Imply Druid MCP

🚀 imply - druid - mcp

這是一個用於 Imply Cloud/Druid 數據庫的只讀 MCP（模型上下文協議）服務器。你可以通過 Claude 和其他 AI 助手對 Druid 數據進行查詢和探索。

🚀 快速開始

imply - druid - mcp 是一個強大的工具，能讓你藉助 AI 助手方便地與 Imply Cloud/Druid 數據庫交互。你可以按照以下步驟進行安裝和配置，開啟數據查詢之旅。

✨ 主要特性

支持的功能 ✅

• SQL 查詢執行
  • 同步查詢執行
  • 異步查詢執行（適用於大型數據集）
• 查詢管理
  • 檢查查詢狀態
  • 獲取查詢結果
  • 取消正在運行的查詢
• 表操作
  • 列出項目中的所有表
  • 獲取表的架構詳細信息
• 儀表盤操作
  • 列出所有儀表盤
  • 獲取儀表盤詳細信息
• 數據立方體操作
  • 列出所有數據立方體
  • 獲取數據立方體詳細信息
  • 執行 Pivot SQL 查詢

不支持的功能 ❌

• 數據攝入
• 表/架構創建或修改
• 用戶/權限管理
• 監督器管理

📦 安裝指南

使用 uvx（推薦）

uvx imply-druid-mcp

使用 pip

pip install imply-druid-mcp
imply-druid-mcp

使用 pipx

pipx install imply-druid-mcp
imply-druid-mcp

📚 詳細文檔

工具介紹

查詢工具

表工具

儀表盤工具

數據立方體工具

API 映射

此 MCP 服務器映射到 [Imply Polaris API](https://docs.imply.io/api/polaris/api - reference)：

配置

*IMPLY_API_KEY 或 IMPLY_ACCESS_TOKEN 二者選其一即可。

Claude 桌面端設置

將以下內容添加到你的 Claude 桌面端配置文件中：

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

{
  "mcpServers": {
    "imply-druid": {
      "command": "uvx",
      "args": ["imply-druid-mcp"],
      "env": {
        "IMPLY_ORGANIZATION": "your-org",
        "IMPLY_REGION": "us-east-1",
        "IMPLY_CLOUD_PROVIDER": "aws",
        "IMPLY_PROJECT_ID": "your-project-id",
        "IMPLY_API_KEY": "your-api-key"
      }
    }
  }
}

💻 使用示例

基礎用法

用戶：顯示我的 Druid 項目中的所有表
Claude：[使用 list_tables]
- wikipedia（數據源）
- events（數據源）
- metrics（數據源）

用戶：查詢 wikipedia 表的前 10 條記錄
Claude：[使用 execute_sql_query 執行 "SELECT * FROM wikipedia LIMIT 10"]
[顯示結果]

用戶：顯示所有數據立方體
Claude：[使用 list_data_cubes]
- sales_cube：銷售分析（來源：sales_table）
- events_cube：事件跟蹤（來源：events）

用戶：查詢銷售數據立方體以獲取排名靠前的城市
Claude：[使用 query_data_cube 並使用 Pivot SQL 語法]
SELECT "DIM:city" AS "City", MEASURE_BY_ID('total_sales') AS "Sales"
FROM "datacube"."sales_cube"
ORDER BY 2 DESC
LIMIT 10

🔧 技術細節

開發

git clone https://github.com/yeongbin-hwang/imply-druid-mcp.git
cd imply-druid-mcp
pip install -e ".[dev]"

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE。

🔗 相關資源

• MCP 協議
• Imply Cloud 文檔
• Apache Druid