Skip to content

v1.0.0 — mcp-metadata-demo

Choose a tag to compare

@DaveGold DaveGold released this 29 May 13:25
· 44 commits to main since this release

First public release — companion demo to the paper The Missing Layer.

A working demonstration of a rich-metadata strategy for AI tooling, applied at two levels in one MCP server:

  • Rich-domain toolget_building_profile fuses Dutch open building data (BAG via PDOK + EP-Online energy labels) into a structured profile with a curated alerts[] array, so an agent reasons about the domain without external priming.
  • Self-describing MCP appsrender_chart, render_table, render_map apply the same metadata strategy to UI configuration; the schemas tell the agent which chart type fits the data, which cell formatters apply, and which marker types to use.

What's inside

  • 5 tools: get_building_profile, render_chart, render_table, render_map, fetch_image
  • Three transports from one createServer() factory: stdio, local HTTP, Firebase Cloud Function
  • MCP Apps UI pipeline: Angular + Vite single-file bundles, Tailwind, Chart.js / Leaflet / TanStack Table
  • Hosted public demo endpoint (no auth, rate-limited)

Try it

Add the hosted endpoint to your MCP client:

{ "mcpServers": { "metadata-demo": { "url": "https://mcp-jtc4p3l6nq-ez.a.run.app" } } }

Or run locally — see the README for stdio setup.