apache-druid-mcp-server

AnilPuram/apache-druid-mcp-server

3.3

If you are the rightful owner of apache-druid-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Apache Druid MCP Server is a Model Context Protocol server designed to facilitate querying and managing Apache Druid datasources.

Tools

  1. query_sql

    Execute SQL queries against Druid

  2. list_datasources

    List all available datasources

  3. describe_datasource

    Get schema information for a datasource

  4. get_datasource_segments

    Get segment information for a datasource

Apache Druid MCP Server

Model Context Protocol (MCP) server for Apache Druid - provides tools and resources for querying and managing Druid datasources.

Quick Start

NPX (Recommended)

npx apache-druid-mcp

Docker

# Build and run with Docker Compose
docker-compose up --build

# Or build and run manually
docker build -t apache-druid-mcp .
docker run -p 3000:3000 \
  -e DRUID_URL=http://localhost:8888 \
  apache-druid-mcp

Local Development

npm install
npm run build
npm start

Configuration

Environment variables:

  • DRUID_URL - Druid router/broker URL (default: http://localhost:8888)
  • DRUID_USERNAME - Optional authentication username
  • DRUID_PASSWORD - Optional authentication password
  • DRUID_TIMEOUT - Request timeout in ms (default: 30000)

Usage

The MCP server provides tools for:

  • query_sql - Execute SQL queries against Druid
  • list_datasources - List all available datasources
  • describe_datasource - Get schema information for a datasource
  • get_datasource_segments - Get segment information for a datasource

Examples

# Connect with Claude Desktop
npx apache-druid-mcp

# Connect to custom Druid instance
DRUID_URL=http://your-druid:8888 npx apache-druid-mcp

License

Apache License 2.0