Druid MCP Server

MCP数据服务

提供方 iunera

数据服务 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude
查看接入方式

一个为Apache Druid设计的全面模型上下文协议(MCP)服务器,提供管理和分析Druid集群的丰富工具、资源和提示。

一句话选型结论

按资料字段整理

Druid MCP Server 属于数据服务类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式支持远程部署
GitHub 星标 12 仓库热度,无公开仓库时显示未标注
工具数 94 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量94暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

数据管理Java本地部署集群管理人工智能集成数据分析企业级解决方案

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
docker run --rm -i \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 94 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 94 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Druid MCP Server当前 94 stdio · 本地进程 支持远程部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方iunera上游标注的维护方 iunera
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

29.9 KB
来自项目仓库与上游目录的原文,未做删改

德鲁伊MCP服务器

一个全面的Apache Druid模型上下文协议(MCP)服务器,为管理和分析Druid集群提供了广泛的工具、资源和提示。

由...开发 六月 -先进的人工智能和数据分析解决方案

概述

此MCP服务器实现了一个基于特征的架构,其中每个包代表Druid管理的一个不同功能区域。服务器提供三种主要类型的MCP组件:

  • 工具 -用于执行操作的可执行函数
  • 资源 -用于访问信息的数据提供者
  • 提示 -人工智能辅助指导模板

视频演练

学习如何使用MCP服务器将AI代理与Apache Druid集成。本教程演示了使用自然语言与Claude、ChatGPT和Gemini等人工智能助手进行时间序列数据探索、统计分析和数据摄取。

点击上面的缩略图在YouTube上观看视频

🧠 Data Philter:人工智能驱动的德鲁伊用户界面

以前所未有的方式体验您的数据 数据采集员,iunera设计的本地首个AI网关。它利用了这一点 德鲁伊MCP服务器 为您的Druid集群提供无缝的对话界面。

  • 自然语言查询: 用简单的英语提问,并立即得到结果。
  • 本地和安全: 完全在本地运行,支持Ollama模型(或OpenAI)。
  • 即插即用: 与Development Druid Installation一起开箱即用。

在GitHub上获取数据Philter→

特性

  • Spring AI MCP服务器集成
  • 基于工具的MCP协议合规架构
  • 基于工具的体系结构:完全符合MCP协议,自动生成JSON模式
  • 多种运输方式:STDIO、SSE和 可流式传输的HTTP 支持包括Oauth
  • 实时通信:具有流媒体功能的服务器发送事件
  • 全面的错误处理
  • 可定制的提示模板:人工智能辅助指导,模板定制
  • 全面的错误处理:优雅的错误处理,有意义的响应

架构与组织

  • 基于特征的包组织:每个包代表一个不同的德鲁伊管理区域
  • 自动发现:通过注释自动注册工具、资源和提示
  • 企业级就绪:生产级配置和安全功能

MCP检查器界面

当连接到MCP客户端时,您可以通过MCP检查器界面检查可用的工具、资源和提示:

可用工具

工具界面显示了所有可用的德鲁伊管理功能,这些功能按功能区域组织,包括数据管理、摄入管理以及监控和健康。

可用资源

资源界面显示所有可访问的Druid数据源和元数据,可以通过MCP协议检索。

可用提示

提示界面显示了可用于各种德鲁伊管理任务和数据分析工作流程的所有AI辅助指导模板。

快速开始

LLM的MCP配置

提供了一个即用型MCP配置文件,网址为 mcp-servers-config.json 它可以与LLM客户端一起使用,以连接到此Druid MCP服务器。

例子

该配置包括两种传输选项:

  • STDIO默认值) (:参见示例/stdio/README.md-服务器是由MCP客户端通过stdio生成的。
  • 流式HTTP(配置文件:HTTP) :请参阅示例/可流式传输的http://README.md-每个mcp 2025-06-18的single/mcp端点。

使用环境变量的Docker示例:```bash

STDIO mode (default)

docker run --rm -i \
-e DRUID_ROUTER_URL=http://your-druid-router:8888 \
-e DRUID_COORDINATOR_URL=http://your-druid-coordinator:8081 \
iunera/druid-mcp-server:latest

HTTP mode (enable profile 'http' and expose /mcp)

docker run -p 8080:8080 \
-e SPRING_PROFILES_ACTIVE=http \
-e DRUID_ROUTER_URL=http://your-druid-router:8888 \
-e DRUID_COORDINATOR_URL=http://your-druid-coordinator:8081 \
iunera/druid-mcp-server:latest


关于Spring配置文件的注意事项:

- 默认配置文件:stdio(不需要SPRING_PROFILES_ACTIVE)
- HTTP配置文件:将SPRING_PROFILES_ACTIVE设置为HTTP,以在/mcp处启用流式HTTP

### 先决条件

- Java 25
- Maven 3.6+
- Apache Druid集群在端口8888上运行路由器

### 构建并运行```bash
# Build the application
mvn clean package -DskipTests

# Run the application
java -jar target/druid-mcp-server-1.8.2.jar

默认情况下,服务器将在端口8080上启动。

有关详细的构建说明、测试、Docker设置和开发指南,请参阅 发展.md.

安全和身份验证

  • 默认情况下,流式HTTP和SSE传输使用OAuth 2.0进行安全保护。
  • 连接时,客户端必须在Authorization标头中发送有效的Bearer令牌。
  • 示例:授权:持有人YOUR_JWT_TOKEN

环境变量

  • DRUID_MCP_SECURITY_OAUTH2_ENABLED:
  • 说明: 启用或禁用客户端身份验证的OAuth2安全性。
  • 类型: 布尔
  • 违约: true (默认情况下,OAuth2已根据上述文本启用)
  • 用途: 设置为 false 禁用OAuth2身份验证。禁用后,客户端可以访问服务器,而无需提供OAuth2令牌。

  • 对于企业SSO集成(OpenID Connect、Azure AD、Keycloak等),请发送查询至 consulting@iunera.com 并看到 联系与支持.

从Maven Central安装

如果你更喜欢使用预构建的JAR而不从源代码构建,你可以直接从Maven Central下载并运行它。

先决条件

  • 仅限Java 25 JRE

下载并运行

从Maven Central下载JARhttps://repo.maven.apache.org/maven2/com/iunera/druid-mcp-server/```bash

STDIO mode (default)

java -jar target/druid-mcp-server-1.8.2.jar

HTTP mode (profile: http) - exposes /mcp on port 8080

java -Dspring.profiles.active=http \
-jar target/druid-mcp-server-1.8.2.jar


## 对于开发者

有关详细的开发信息,包括构建说明、测试指南、架构细节和贡献指南,请参阅 发展.md.

## 按功能列出的可用工具

MCP服务器通过注释自动发现所有工具。在只读模式下,任何修改Druid集群的工具都不会注册,也不会出现在MCP客户端中。以下列表反映了当前的实施情况。

### 数据管理

|特性|工具|描述|参数|
|---------|------|-------------|------------|
| **数据源** | `listDatasources` |列出所有可用的Druid数据源名称|无|
| **数据源** | `showDatasourceDetails` |显示特定数据源的详细信息,包括列信息| `datasourceName` (字符串)|
| **数据源** | `killDatasource` |永久关闭数据源,删除所有数据和元数据| `datasourceName` (字符串), `interval` (字符串)|
| **查找** | `listLookups` |列出协调器中所有可用的Druid查找|无|
| **查找** | `getLookupConfig` |获取特定查找的配置| `tier` (字符串), `lookupName` (字符串)|
| **查找** | `updateLookupConfig` |更新特定查找的配置| `tier` (字符串), `lookupName` (字符串), `config` (字符串)|
| **片段** | `listAllSegments` |列出所有数据源中的所有段|无|
| **片段** | `getSegmentMetadata` |获取特定细分市场的元数据| `datasourceName` (字符串), `segmentId` (字符串)|
| **片段** | `getSegmentsForDatasource` |获取特定数据源的所有段| `datasourceName` (字符串)|
| **查询** | `queryDruidSql` |对Druid数据源执行SQL查询| `sqlQuery` (字符串)|
| **留存** | `viewRetentionRules` |查看所有数据源或特定数据源的保留规则| `datasourceName` (字符串,可选)|
| **留存** | `updateRetentionRules` |更新数据源的保留规则| `datasourceName` (字符串), `rules` (字符串)|
| **压实** | `viewAllCompactionConfigs` |查看所有数据源的压缩配置|无|
| **压实** | `viewCompactionConfigForDatasource` |查看特定数据源的压缩配置| `datasourceName` (字符串)|
| **压实** | `editCompactionConfigForDatasource` |编辑数据源的压缩配置| `datasourceName` (字符串), `config` (字符串)|
| **压实** | `deleteCompactionConfigForDatasource` |删除数据源的压缩配置| `datasourceName` (字符串)|
| **压实** | `viewCompactionStatus` |查看所有数据源的压缩状态|无|
| **压实** | `viewCompactionStatusForDatasource` |查看特定数据源的压缩状态| `datasourceName` (字符串)|

### 摄入管理

|特性|工具|描述|参数|
|---------|------|-------------|------------|
| **摄入规格** | `createBatchIngestionTemplate` |创建批接收模板| `datasourceName` (字符串), `inputSource` (字符串), `timestampColumn` (字符串)|
| **摄入规格** | `createIngestionSpec` |创建并提交摄入规范| `specJson` (字符串)|
| **主管人员** | `listSupervisors` |列出所有流媒体接收主管|无|
| **主管人员** | `getSupervisorStatus` |获取特定主管的状态| `supervisorId` (字符串)|
| **主管人员** | `suspendSupervisor` |暂停流媒体主管| `supervisorId` (字符串)|
| **主管人员** | `startSupervisor` |启动或恢复流媒体主管| `supervisorId` (字符串)|
| **主管人员** | `terminateSupervisor` |终止流媒体主管| `supervisorId` (字符串)|
| **任务** | `listTasks` |列出所有摄入任务|无|
| **任务** | `getTaskStatus` |获取特定任务的状态| `taskId` (字符串)|
| **任务** | `shutdownTask` |关闭正在运行的任务| `taskId` (字符串)|

### 监测与健康

|特性|工具|描述|参数|
|---------|------|-------------|------------|
| **基本健康** | `checkClusterHealth` |检查总体群集运行状况|无|
| **基本健康** | `getServiceStatus` |获取特定德鲁伊服务的状态| `serviceType` (字符串)|
| **基本健康** | `getClusterConfiguration` |获取群集配置信息|无|
| **诊断** | `runDruidDoctor` |运行全面的群集诊断|无|
| **诊断** | `analyzePerformanceIssues` |分析群集性能问题|无|
| **诊断** | `generateHealthReport` |生成详细的健康报告|无|
| **功能** | `testQueryFunctionality` |跨服务测试查询功能|无|
| **功能** | `testIngestionFunctionality` |测试摄入功能|无|
| **功能** | `validateClusterConnectivity` |验证群集组件之间的连接|无|

### 基本保障

|特性|工具|描述|参数|
|---------|------|-------------|------------|
| **认证** | `listAuthenticationUsers` |列出特定身份验证器的Druid身份验证系统中的所有用户| `authenticatorName` (字符串)|
| **认证** | `getAuthenticationUser` |从Druid身份验证系统获取特定用户的详细信息| `authenticatorName` (字符串), `userName` (字符串)|
| **认证** | `createAuthenticationUser` |在Druid身份验证系统中创建新用户| `authenticatorName` (字符串), `userName` (字符串)|
| **认证** | `deleteAuthenticationUser` |从Druid身份验证系统中删除用户。请谨慎使用,因为此操作无法撤消。 | `authenticatorName` (字符串), `userName` (字符串)|
| **认证** | `setUserPassword` |在Druid身份验证系统中设置或更新用户的密码| `authenticatorName` (字符串), `userName` (字符串), `password` (字符串)|
| **授权** | `listAuthorizationUsers` |列出特定授权人在Druid授权系统中的所有用户| `authorizerName` (字符串)|
| **授权** | `getAuthorizationUser` |从Druid授权系统获取特定用户的详细信息,包括他们的角色| `authorizerName` (字符串), `userName` (字符串)|
| **授权** | `listRoles` |列出特定授权者在德鲁伊授权系统中的所有角色| `authorizerName` (字符串)|
| **授权** | `getRole` |从德鲁伊授权系统获取特定角色的详细信息,包括其权限| `authorizerName` (字符串), `roleName` (字符串)|
| **授权** | `createAuthorizationUser` |在Druid授权系统中创建新用户| `authorizerName` (字符串), `userName` (字符串)|
| **授权** | `deleteAuthorizationUser` |从Druid授权系统中删除用户。请谨慎使用,因为此操作无法撤消。 | `authorizerName` (字符串), `userName` (字符串)|
| **授权** | `createRole` |在德鲁伊授权系统中创建新角色| `authorizerName` (字符串), `roleName` (字符串)|
| **授权** | `deleteRole` |从德鲁伊授权系统中删除角色。请谨慎使用,因为此操作无法撤消。 | `authorizerName` (字符串), `roleName` (字符串)|
| **授权** | `setRolePermissions` |在Druid授权系统中设置角色的权限。以JSON数组的形式提供权限。 | `authorizerName` (字符串), `roleName` (字符串), `permissions` (字符串)|
| **授权** | `assignRoleToUser` |在Druid授权系统中为用户分配角色| `authorizerName` (字符串), `userName` (字符串), `roleName` (字符串)|
| **授权** | `unassignRoleFromUser` |在Druid授权系统中取消分配用户的角色| `authorizerName` (字符串), `userName` (字符串), `roleName` (字符串)|
| **配置** | `getAuthenticatorChainAndAuthorizers` |获取配置的authenticatorChain和授权器构成基本Auth配置。此信息对于任何其他安全工具都很重要,LLM需要先调用此工具。|无|

## 按功能列出的可用资源

|特性|资源URI模式|描述|参数|
|---------|---------------------|-------------|------------|
| **数据源** | `druid://datasource/{datasourceName}` |访问数据源信息和元数据| `datasourceName` (字符串)|
| **数据源** | `druid://datasource/{datasourceName}/details` |访问包括架构在内的详细数据源信息| `datasourceName` (字符串)|
| **查找** | `druid://lookup/{tier}/{lookupName}` |访问查找配置和数据| `tier` (字符串), `lookupName` (字符串)|
| **片段** | `druid://segment/{segmentId}` |访问段元数据和信息| `segmentId` (字符串)|

## 按功能列出的可用提示

|功能|提示名称|描述|参数|
|---------|-------------|-------------|------------|
| **数据分析** | `data-exploration` |Druid数据源数据探索指南| `datasource` (字符串,可选)|
| **数据分析** | `query-optimization` |帮助优化Druid SQL查询以获得更好的性能| `query` (字符串)|
| **群集管理** | `health-check` |综合集群健康评估指南|无|
| **群集管理** | `cluster-overview` |集群状态概述和分析|无|
| **摄入管理** | `ingestion-troubleshooting` |排除摄入问题| `issue` (字符串,可选)|
| **摄入管理** | `ingestion-setup` |设置新摄入管道指南| `dataSource` (字符串,可选)|
| **保留管理** | `retention-management` |管理数据保留策略| `datasource` (字符串,可选)|
| **压实** | `compaction-suggestions` |优化管片压实配置| `datasource` (字符串,可选), `currentConfig` (字符串,可选), `performanceMetrics` (字符串,可选)|
| **压实** | `compaction-troubleshooting` |解决压实问题| `issue` (字符串), `datasource` (字符串,可选)|
| **运营** | `emergency-response` |应急响应程序和指导|无|
| **运营** | `maintenance-mode` |集群维护程序|无|

### 环境变量配置

可以使用环境变量配置应用程序,这是生产环境的推荐方法。以下是从 `application.yaml` 配置文件。

#### 德鲁伊连接

- `DRUID_ROUTER_URL`:Druid路由器的URL。
- `DRUID_AUTH_USERNAME`:Druid身份验证的用户名。
- `DRUID_AUTH_PASSWORD`:德鲁伊身份验证的密码。
- `DRUID_SSL_ENABLED`:启用或禁用Druid连接的SSL(true/false)。
- `DRUID_SSL_SKIP_VERIFICATION`:跳过SSL证书验证(真/假)。

#### MCP服务器配置

- `DRUID_MCP_SECURITY_OAUTH2_ENABLED`:启用或禁用客户端身份验证的OAuth2安全性(true/false)。
- `DRUID_MCP_READONLY_ENABLED`:启用或禁用只读模式(真/假)。
- `DRUID_EXTENSION_DRUID_BASIC_SECURITY_ENABLED`:启用或禁用基本安全功能(true/false)。禁用时,基本安全工具不会注册。
- `SPRING_AI_MCP_SERVER_NAME`:MCP服务器的名称。
- `SPRING_AI_MCP_SERVER_PROTOCOL`MCP服务器使用的协议(例如。, `streamable`).

#### 常规服务器配置

- `SERVER_PORT`:服务器侦听的端口。
- `SERVER_SERVLET_SESSION_COOKIE_NAME`:会话cookie的名称。
- `SPRING_APPLICATION_NAME`:应用程序的名称。
- `SPRING_CONFIG_IMPORT`:导入其他配置文件。
- `SPRING_MAIN_BANNER_MODE`:启动横幅的模式(例如。, `off`).

#### 日志记录

- `LOGGING_FILE_NAME`:日志文件的名称。
- `LOGGING_LEVEL_ORG_SPRINGFRAMEWORK_SECURITY`:Spring Security的日志级别(例如。, `DEBUG`).

### 带身份验证的SSL加密群集

本节提供了有关使用用户名和密码身份验证连接到SSL加密的Druid集群的全面指导。

#### 先决条件

- 具有HTTPS端点的启用SSL的Druid集群
- 用于Druid身份验证的有效用户名和密码凭据
- 正确配置SSL证书(或跳过测试验证的能力)

#### 配置方法

##### 方法1:环境变量(推荐用于生产)

启动MCP服务器之前,请设置以下环境变量:```bash
# Druid cluster URL with HTTPS
export DRUID_ROUTER_URL="https://your-druid-cluster.example.com:8888"

# Authentication credentials
export DRUID_AUTH_USERNAME="your-username"
export DRUID_AUTH_PASSWORD="your-password"

# SSL configuration
export DRUID_SSL_ENABLED="true"
export DRUID_SSL_SKIP_VERIFICATION="false"  # Use "true" only for testing

# Start the MCP server
java -jar target/druid-mcp-server-1.8.2.jar
方法2:运行时系统属性

将配置作为JVM系统属性传递:```bash
java -Ddruid.router.url="http://localhost:8888" \
-Ddruid.auth.username="admin" \
-Ddruid.auth.password="password" \
-jar target/druid-mcp-server-1.8.2.jar


#### SSL配置选项

##### 生产SSL设置

对于具有有效SSL证书的生产环境:```bash
export DRUID_ROUTER_URL="https://druid-prod.company.com:8888"
export DRUID_SSL_ENABLED="true"
export DRUID_SSL_SKIP_VERIFICATION="false"

服务器将使用系统的默认信任库来验证SSL证书。

身份验证方法

MCP服务器支持使用用户名和密码的HTTP基本身份验证:

  • 用户名:通过设置 DRUID_AUTH_USERNAME 或 druid.auth.username
  • 密码:通过设置 DRUID_AUTH_PASSWORD 或 druid.auth.password

凭据使用Base64自动编码,并使用 Authorization: Basic 头球

带SSL的MCP客户端配置

更新您的 mcp-servers-config.json 包括环境变量:```json
{
"mcpServers": {
"druid-mcp-server": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"DRUID_ROUTER_URL",
"-e",
"DRUID_COORDINATOR_URL",
"-e",
"DRUID_AUTH_USERNAME",
"-e",
"DRUID_AUTH_PASSWORD",
"-e",
"DRUID_SSL_ENABLED",
"-e",
"DRUID_SSL_SKIP_VERIFICATION",
"-e",
"DRUID_MCP_READONLY_ENABLED",
"iunera/druid-mcp-server:1.8.2"
],
"env": {
"DRUID_ROUTER_URL": "http://host.docker.internal:8888",
"DRUID_COORDINATOR_URL": "http://host.docker.internal:8081",
"DRUID_AUTH_USERNAME": "",
"DRUID_AUTH_PASSWORD": "",
"DRUID_SSL_ENABLED": "false",
"DRUID_SSL_SKIP_VERIFICATION": "true",
"DRUID_MCP_READONLY_ENABLED": "false"
}
}
}
}


## MCP提示定制

服务器通过以下方式提供广泛的提示定制功能 `prompts.properties` 文件位于 `src/main/resources/`.

### 提示配置结构

prompts.properties文件包含:

1. **全局设置**:启用/禁用提示并设置水印
1. **功能开关**:控制哪些提示可用
1. **自定义变量**:组织特定信息
1. **模板定义**:每个功能的完整提示模板

### 超越提示

您可以使用Java系统属性覆盖任何提示模板 `-D` 标志:

#### 方法1:系统属性(运行时覆盖)```bash
java -Dprompts.druid-data-exploration.template="Your custom template here" \
-jar target/druid-mcp-server-1.8.2.jar

方法2:自定义特性文件

  1. 创建自定义属性文件(例如。, custom-prompts.properties):```properties

Custom prompt template

prompts.druid-data-exploration.template=My custom data exploration prompt:\n\
1. Custom step one\n\
2. Custom step two\n\
{datasource_section}\n\
Environment: {environment}


2. 在运行时加载它:```bash
java -Dspring.config.additional-location=classpath:custom-prompts.properties \
-jar target/druid-mcp-server-1.8.2.jar

可用提示变量

所有提示模板都支持这些变量:

变量 描述 示例
{environment} 当前环境名称 production, staging, dev
{organizationName} 组织名称 Your Organization
{contactInfo} 联系方式 your-team@company.com
{watermark} 生成的水印 Generated by Druid MCP Server v1.0.0
{datasource} 数据源名称(特定于上下文) sales_data
{query} SQL查询(特定于上下文) SELECT * FROM sales_data

提示模板示例

自定义数据探索提示```properties

prompts.druid-data-exploration.template=Welcome to {organizationName} Druid Analysis!\n\n\
Please help me explore our data:\n\
{datasource_section}\n\
Environment: {environment}\n\
Contact: {contactInfo}\n\n\
{watermark}


#### 自定义查询优化提示```properties
prompts.druid-query-optimization.template=Query Performance Analysis for {organizationName}\n\n\
Query to optimize: {query}\n\n\
Please provide:\n\
1. Performance bottleneck analysis\n\
2. Optimization recommendations\n\
3. Best practices for our {environment} environment\n\n\
{watermark}

禁用特定提示

您可以通过将单个提示的启用标志设置为false来禁用它们:```properties
mcp.prompts.data-exploration.enabled=false
mcp.prompts.query-optimization.enabled=false


或者全局禁用所有提示:```properties
mcp.prompts.enabled=false

MCP集成

该服务器使用Spring AI的MCP服务器框架,支持STDIO和SSE传输。工具、资源和提示通过MCP协议自动注册和公开。

运输方式

Druid MCP服务器支持多种符合MCP 2025-06-18规范的传输模式:

流式HTTP传输(推荐)

新 可流式传输的HTTP 传输提供了增强的性能和可扩展性,支持多个并发客户端:```bash

Default configuration with Streamable HTTP

java -Dspring.profiles.active=http \
-jar target/druid-mcp-server-1.8.2.jar

Server available at http://localhost:8080/mcp (configurable endpoint)


**特征:**

- **单端点**:一个HTTP端点同时处理POST和GET请求
- **多个客户端**:支持并发客户端连接
- **可选SSE流媒体**:服务器发送实时更新事件
- **增强安全性**:源标头验证和身份验证
- **向后兼容**:旧MCP客户端的自动回退
- **保持连接**:可配置的连接健康监测

安全

- 默认情况下,流式HTTP和SSE模式由OAuth保护。您的MCP客户端在连接时必须获取并发送有效的承载令牌。
- 对于企业SSO集成(OpenID Connect、Azure AD、Keycloak等),请发送查询至 consulting@iunera.com 并看到 联系与支持.

#### STDIO传输(命令行集成)

非常适合LLM客户端和桌面应用程序:```bash
java -jar target/druid-mcp-server-1.8.2.jar

传统SSE传输(已弃用)

仍然支持向后兼容性。它不再是默认设置,可能会在未来的版本中删除。

注意:默认情况下,SSE端点使用OAuth进行保护。客户端在连接时必须包含有效的承载令牌。有关SSO集成支持,请参阅 联系与支持.

只读模式

只读模式可以防止任何可能改变Druid集群的操作,同时仍然允许安全的读取操作和SQL查询。启用时:

  • 允许所有HTTP GET请求
  • HTTP POST只允许到精确的路径/drui/v2/sql(用于SELECT和其他只读sql)
  • 任何其他HTTP方法(PUT、PATCH、DELETE)都被阻止
  • 任何其他POST端点(例如摄入/任务端点)都被阻止
  • MCP写入工具未注册,因此它们不会出现在您的MCP客户端的工具列表中

启用只读模式

您可以使用以下任何方法启用它:

  1. application.properties```
    druid.mcp.readonly.enabled=true

2. 环境变量```bash
export DRUID_MCP_READONLY_ENABLED=true
  1. JVM系统属性```bash
    java -Ddruid.mcp.readonly.enabled=true -jar target/druid-mcp-server-1.8.2.jar

4. 码头工人```bash
docker run --rm -p 8080:8080 \
-e DRUID_MCP_READONLY_ENABLED=true \
iunera/druid-mcp-server:latest

只读模式有哪些变化?

  • 修改集群的工具已被禁用,MCP客户端不会列出这些工具。示例包括:
  • 分段状态更改(启用分段、禁用分段)
  • 数据源删除(killDatasource)
  • 保留规则编辑(editRetentionRulesForDatasource)
  • 压缩配置编辑(editCompactConfigForDatasource,deleteCompactConfigForDatasource)
  • 查找更改(createOrUpdateLookup、deleteLookup)
  • 监督员控制(暂停监督员、启动监督员、终止监督员)
  • 任务控制(killTask)
  • 多阶段SQL任务操作(queryDruidMultiStage、queryDruidMulti-StageWithContext、getMultiStageQueryTaskStatus、cancelMultiStageQuery任务)
  • 摄入规范提交和模板(创建摄入规范,创建批量摄入模板)
  • 基本安全更改工具(例如。, createAuthenticationUser, deleteAuthenticationUser, setUserPassword, createAuthorizationUser, deleteAuthorizationUser, createRole, deleteRole, setRolePermissions, assignRoleToUser, unassignRoleFromUser)
  • 只读安全工具仍然可用,包括SQL查询(queryDruidSql)、元数据和状态查找、健康诊断、任务和段检查等。

指标收集

为了增强产品并了解使用模式,此服务器收集匿名使用指标。这些数据有助于确定新功能和改进的优先级。您可以通过设置 druid.mcp.metrics.enabled “假。

🐳 开发德鲁伊安装

对于本地开发、测试和学习,可以在以下网址获得运行完整Apache Druid集群的完整Docker Compose设置 iunera/drui本地集群安装程序.

此设置是让Druid集群运行以与此MCP服务器一起使用的推荐方法。

主要特点:

  • 完整德鲁伊星团: 包括所有核心德鲁伊服务(协调员、经纪人、历史、中间管理者、路由器)。
  • 一个命令安装: 适用于macOS、Linux和Windows的自动化脚本。
  • 跨平台: 在Docker可用的任何地方运行。
  • 预配置: 对当地发展的合理违约。
  • 已启用基本安全: 预先配置的管理员用户(admin/password).
  • 数据采集准备就绪: 设计用于开箱即用 iunera/data-philter.

相关项目

这个Druid MCP服务器是iunera开发的Apache Druid工具和扩展的综合生态系统的一部分。这些互补项目增强了Druid集群管理和数据摄取的不同方面:

🔧 德鲁伊集群配置

Apache Druid集群的高级配置管理和部署工具。该项目提供:

  • 自动群集设置:针对不同部署场景简化了配置模板
  • 配置管理:生产Druid集群的最佳实践和模板
  • 部署自动化:用于一致集群部署的工具和脚本
  • 环境特定配置:优化了开发、暂存和生产环境的配置

与Druid MCP服务器集成:该项目提供的集群配置与Druid MCP Server的监控和管理功能无缝协作,实现了全面的集群生命周期管理。

📊 代码摄入德鲁伊扩展

一个专门的Apache Druid扩展,用于摄取和分析与代码相关的数据和指标。此扩展允许:

  • 代码度量摄入:用于代码分析数据和软件度量的专用解析器
  • 开发者分析:用于分析代码质量、复杂性和开发模式的工具
  • CI/CD集成:与持续集成和部署管道无缝集成
  • 自定义数据格式:支持各种代码分析工具和格式

与Druid MCP服务器集成:此扩展扩展了可以通过MCP服务器的摄入管理工具进行管理的摄入功能,为代码分析用例提供了专门的支持。

为什么要一起使用这些?

  • 完整的生态系统:从集群设置到专门的数据摄取和管理
  • 一致的架构:所有项目都遵循类似的设计原则和集成模式
  • 增强功能:每个项目都扩展了德鲁伊生态系统的不同方面
  • 生产就绪:用于企业部署的经过实战测试的配置和扩展

路线图

  • 德鲁伊自动压实:智能自动压实配置
  • MCP自动完成:使用McpComplete进行采样,增强自动补全功能
  • MCP通知:MCP操作的实时通知
  • 适当的可观察性:综合指标和跟踪
  • 增强监控:先进的集群监控和警报功能
  • 高级分析:基于机器学习的见解和建议
  • Kubernetes支持:在Kubernetes上正确部署

关于iunera

此Druid MCP服务器由以下公司开发和维护 六月,领先的先进人工智能和数据分析解决方案提供商。

iunera专门从事:

  • 人工智能驱动的分析:用于数据分析的尖端人工智能解决方案
  • 企业数据平台:可扩展的数据基础设施和分析平台(Druid、Flink、Kubernetes、Kafka、Spring)
  • 模型上下文协议(MCP)解决方案:各种数据系统的高级MCP服务器实现
  • 定制人工智能开发:为企业需求量身定制的人工智能解决方案

作为Apache Druid iunera的老手,部署和维护了大量基于 阿帕奇德鲁伊 在生产性企业级场景中。

需要Apache德鲁伊专家咨询?

最大化您的数据回报 提供专业的Druid实施和优化服务。从架构设计到性能调优和人工智能集成,我们的专家帮助您驾驭Druid的复杂性,并释放其全部潜力。

获得专家德鲁伊咨询→

需要企业MCP服务器开发咨询?

企业人工智能集成与定制MCP(模型上下文协议)服务器开发

Iunera专注于开发生产级AI代理和企业级LLM解决方案,帮助企业超越通用AI聊天机器人。他们构建了安全、可扩展和面向未来的人工智能基础设施,以模型上下文协议(MCP)为基础,将专有数据、遗留系统和外部API连接到高级人工智能模型。

获取企业MCP服务器开发咨询→

有关我们的服务和解决方案的更多信息,请访问 网站:www.iunera.com.

联系与支持

需要帮助?让

  • 网站: https://www.iunera.com
  • 专业服务:通过以下方式联系我们 电子邮件 为了 Apache Druid企业咨询、支持和定制开发
  • 开源:该项目是开源的,欢迎社区贡献

© 2024 六月。根据Apache许可证2.0授权。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Druid MCP Server 怎么安装?

在客户端按下面的安装命令接入:docker run --rm -i \。装完在客户端配置里引用同一个包或端点。

Druid MCP Server 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Druid MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Druid MCP Server 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Druid MCP Server 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Druid MCP Server 能提供哪些能力?

资料显示约 94 个工具;能力标签包括 数据管理、集群管理、Java、Claude。具体工具清单以官方文档为准。

Druid MCP Server 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Druid MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。