Skip to content

Add ad-hoc agent/MCP query demo and deployable MCP server#60

Open
felihong wants to merge 1 commit into
databrickslabs:mainfrom
felihong:add-agent-mcp-query-demo
Open

Add ad-hoc agent/MCP query demo and deployable MCP server#60
felihong wants to merge 1 commit into
databrickslabs:mainfrom
felihong:add-agent-mcp-query-demo

Conversation

@felihong

Copy link
Copy Markdown

Summary

  • demos/agent_mcp_query: answers ad-hoc questions against an Impulse silver layer by building and computing a report on the fly (channels/events/bins/virtual signals as call-time parameters, no report defined in code ahead of time and no persisted Gold table), then exposes that logic as MCP tools (list_channels, list_containers, preview_histogram, preview_histogram_2d, preview_stats, preview_point_values) with an in-notebook round trip against real data.
  • demos/agent_mcp_app: a deployable Databricks App hosting the same tools as a custom MCP server, reachable from AI Playground or any MCP-compatible agent. See its README.md for setup, dependency-pin rationale, and known limitations (no per-user auth yet; distance/custom-weighted histograms gated off after finding they produce numerically incorrect results — the notebook's Section 3 has the repro).

Test plan

  • Run demos/agent_mcp_query top to bottom on a serverless cluster with a fresh catalog/schema; confirm the in-notebook MCP round trip (Section 5) returns real data for all 6 tools.
  • Deploy demos/agent_mcp_app per its README; confirm it's discoverable in AI Playground and that list_channels/preview_histogram/preview_histogram_2d return correct results against the deployed app.
  • Spot-check the AI Playground test questions in Section 7 of the notebook.

This pull request and its description were written by Isaac.

Adds demos/agent_mcp_query, showing how to answer ad-hoc questions
against an Impulse silver layer by building and computing a report
on the fly (channels/events/bins as call-time parameters, no
persisted Gold table), then exposing that logic as MCP tools.

Adds demos/agent_mcp_app, a deployable Databricks App that hosts the
same tools as a custom MCP server reachable from AI Playground or any
MCP-compatible agent.
@felihong
felihong requested a review from a team as a code owner July 10, 2026 16:00
@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants