mcp-data-platform-v0.11.0

Overview

Two major features in this release:

1. Custom MCP Apps - Build and deploy your own interactive UI components for tool results. Query results can now render as sortable tables, charts, or any custom visualization you create. Ship your apps with the platform or mount them at runtime.

2. Agent Discovery & Instructions - New configuration fields help agents understand when to use this MCP server. Tags, descriptions, and prompts communicate business context so agents can route questions to the right platform.

New Features

Custom MCP Apps (#37)

Build interactive UIs for your tool results. Instead of raw JSON, users see sortable tables, charts, filters, and custom visualizations. You build the app, the platform handles the plumbing.

What You Can Build:

• Query result tables with sorting, filtering, and export
• Data visualizations and charts
• Custom dashboards for specific tools
• Interactive forms for complex tool inputs

How It Works:

1. Create an HTML/JS/CSS app that follows the MCP Apps protocol
2. Point the platform to your app's assets directory
3. Map your app to specific tools
4. Tool results automatically render in your custom UI

mcpapps:
  enabled: true
  apps:
    query-results:
      enabled: true
      tools:
        - trino_query
        - trino_describe_table
      assets_path: "/opt/mcp-apps/query-results"
      entry_point: "index.html"
      csp:
        resource_domains:
          - "https://cdn.jsdelivr.net"
        clipboard_write: true
      config:
        theme: "auto"
        max_rows: 1000

Configuration Options:

• assets_path - Directory containing your HTML/JS/CSS app
• tools - Which tools trigger this app
• resource_uri - Custom MCP resource URI (default: ui://<app-name>)
• csp.resource_domains - CDNs for scripts, styles, fonts
• csp.connect_domains - APIs your app can call
• csp.clipboard_write - Enable copy-to-clipboard
• config - App-specific settings injected as JSON

Development:

docker compose -f docker-compose.dev.yml up
# Open http://localhost:8000/test-harness.html
# Edit your app, click Reload, see changes instantly

Docker Deployment:

Apps in the apps/ directory are bundled with the Docker image at /usr/share/mcp-data-platform/apps/. Mount custom apps to /etc/mcp-apps/.

---

Agent Discovery & Instructions (#38)

MCP servers run in the background. When a user asks about "ACME Corp sales data," the agent needs to know which MCP server handles that. New configuration fields solve this:

server:
  name: "ACME Corp Data Platform"
  description: |
    Use this MCP server for all questions about ACME Corp, including X Widget sales,
    Thing Mart inventory, customer analytics, and financial reporting.
  tags:
    - "ACME Corp"
    - "X Widget"
    - "Thing Mart"
    - "sales"
    - "inventory"
  agent_instructions: |
    Prices are in cents - divide by 100.
    Always filter mode = 'live'.
  prompts:
    - name: routing_rules
      description: "How to route queries between systems"
      content: |
        Before querying, determine if you need ENTITY STATE or ANALYTICS...

New Fields:

Field	Purpose
server.name	Platform identity - helps agents identify which business this MCP serves
server.description	Explains when to use this MCP - agents route questions based on this
server.tags	Keywords for discovery: company names, products, domains
server.agent_instructions	Operational guidance: data conventions, required filters
server.prompts	Platform-level MCP prompts registered via prompts/list

How It Works:

1. platform_info tool returns tags and agent_instructions in its response
2. Tool description dynamically includes platform name and tags for discoverability
3. Prompts are registered as MCP prompts, retrievable via prompts/get

Platform Info App Enhancement

The built-in platform-info MCP App now displays tags as badges in the header, providing visual context about the platform's business domain.

Breaking Changes

None. All new fields are optional and backward compatible.

Upgrade Guide

1. Update to v0.11.0
2. (Optional) Add tags, agent_instructions, and prompts to your server config
3. (Optional) Build and configure custom MCP Apps

Changelog

Others

• a2406be: Custom MCP App Support (#37) (@cjimti)
• 9046654: Fix Docker Build Missing Apps Directory (#40) (@cjimti)
• 001b432: Separate Agent Instructions from Description (#38) (#39) (@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.11.0

Verification

All release artifacts are signed with Cosign. Verify with:

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