MCP Server Overview

This MCP server connects AI assistants to your data infrastructure for exploration and analysis. It's not an API wrapper. It's a platform that understands your data's business context.

What It Does

DataHub is required. It's the semantic layer that gives meaning to your data. Trino and S3 are optional:

• DataHub - Search your catalog, explore lineage, understand what data means
• Trino - Run SQL queries (results include DataHub context automatically)
• S3 - Access files in object storage (with DataHub metadata when available)

The difference from standalone tools: cross-injection. Query a table in Trino, get DataHub's business context in the response. Search DataHub, see which datasets are queryable.

Architecture

graph TB
    Client[MCP Client<br/>Claude Desktop / Claude Code]

    subgraph Platform[mcp-data-platform]
        Auth[Authentication]
        Persona[Persona Mapping]

        subgraph Toolkits
            Trino[Trino Toolkit]
            DataHub[DataHub Toolkit]
            S3[S3 Toolkit]
        end

        Enrichment[Semantic Enrichment]
        Audit[Audit Logging]
    end

    subgraph Services
        TrinoSvc[Trino Cluster]
        DataHubSvc[DataHub Instance]
        S3Svc[S3 / MinIO]
    end

    Client --> Auth
    Auth --> Persona
    Persona --> Toolkits
    Toolkits --> Enrichment
    Enrichment --> Audit
    Audit --> Client

    Trino --> TrinoSvc
    DataHub --> DataHubSvc
    S3 --> S3Svc

Request Flow

For HTTP (remote) deployments:

1. Auth - Validate OIDC token or API key
2. Persona - Map user roles to tool permissions
3. Execute - Run the tool
4. Enrich - Add DataHub context to results
5. Audit - Log the request

For stdio (local), skip steps 1-2. Your machine, your credentials.

Transport

Transport	When to use
stdio	Local. Claude Code, development.
HTTP	Remote. Shared server, Claude Desktop connecting over network. Serves both SSE and Streamable HTTP.

Minimal Configuration

DataHub is required. Add Trino and S3 if you have them:

server:
  name: mcp-data-platform
  transport: stdio

toolkits:
  datahub:
    primary:
      url: https://datahub.example.com
      token: ${DATAHUB_TOKEN}

  # Optional: add Trino for SQL queries
  trino:
    primary:
      host: trino.example.com
      port: 443
      user: analyst
      ssl: true
      catalog: hive

injection:
  trino_semantic_enrichment: true
  datahub_query_enrichment: true

Next Steps

• Installation
• Configuration
• Tools