mcp-data-platform-v0.5.0

URN Mapping for Semantic Context Enrichment

This release fixes semantic context enrichment when Trino catalog/platform names differ from DataHub metadata catalog names.

What's New

URN Mapping Configuration - Configure translation between query engine and metadata catalog names:

semantic:
  provider: datahub
  instance: primary
  urn_mapping:
    platform: postgres
    catalog_mapping:
      rdbms: warehouse
      iceberg: datalake

Complete Enrichment Output - Tool responses now include all available semantic metadata:

• urn - DataHub URN for cross-referencing
• glossary_terms - Business glossary terms
• custom_properties - User-defined metadata
• last_modified - Timestamp of last update

Debug Logging - Added slog.Debug logging when enrichment fails to help diagnose URN mapping issues.

Bug Fixes

• Fixed silent failure when Trino catalog names don't match DataHub catalog names
• Fixed missing fields in semantic enrichment output

Breaking Changes

None.

Upgrade Guide

No action required. Existing configurations continue to work. To use URN mapping, add the urn_mapping section to your semantic configuration.

Files Changed

• pkg/platform/config.go - Added URNMappingConfig struct
• pkg/semantic/datahub/adapter.go - Catalog mapping in URN building
• pkg/middleware/semantic.go - Complete enrichment output, debug logging
• pkg/platform/platform.go - Wire URN mapping to adapter
• configs/platform.yaml - Documented URN mapping configuration
• docs/reference/configuration.md - URN mapping documentation
• docs/cross-injection/trino-datahub.md - URN mapping and troubleshooting
• docs/llms-full.txt - LLM-readable documentation update

Changelog

Others

• c8fb763: semantic context enrichment (#14) (@cjimti)

Installation

Homebrew (macOS)

brew install txn2/tap/mcp-data-platform

Claude Code CLI

claude mcp add mcp-data-platform -- mcp-data-platform

Docker

docker pull ghcr.io/txn2/mcp-data-platform:v0.5.0

Verification

All release artifacts are signed with Cosign. Verify with:

cosign verify-blob --bundle mcp-data-platform_0.5.0_linux_amd64.tar.gz.sigstore.json \
  mcp-data-platform_0.5.0_linux_amd64.tar.gz