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