MCP Server Part 6: Format callback results for LLM consumption

[KoolADE85]

Summary

• Add formatters that enrich callback responses with LLM-friendly content (images, markdown tables) for certain data types
• PlotlyFigureResult — renders Graph.figure outputs as PNG images via kaleido, returned as ImageContent
• DataFrameResult — renders DataTable.data and AgGrid.rowData outputs as markdown tables, returned as TextContent

Manual verification:

import plotly.express as px
from dash import Dash, html, dcc, Input, Output, dash_table

df = px.data.gapminder().query("year == 2007 and continent == 'Europe'")

app = Dash(__name__)
app.layout = html.Div([
    dcc.Dropdown(id="metric", options=["gdpPercap", "lifeExp", "pop"], value="gdpPercap"),
    dcc.Graph(id="chart"),
    dash_table.DataTable(id="table"),
])

@app.callback(Output("chart", "figure"), Input("metric", "value"))
def update_chart(metric):
    """Bar chart of the selected metric across European countries."""
    return px.bar(df, x="country", y=metric, title=f"{metric} in Europe (2007)")

@app.callback(Output("table", "data"), Input("metric", "value"))
def update_table(metric):
    """Top 5 countries for the selected metric."""
    return df.nlargest(5, metric)[["country", metric]].to_dict("records")

with app.server.app_context():
    from dash.mcp.primitives.tools.callback_adapter_collection import CallbackAdapterCollection
    from dash.mcp.primitives.tools.callback_utils import run_callback
    from dash.mcp.primitives.tools.results import format_callback_response

    collection = CallbackAdapterCollection(app)
    for adapter in collection:
        response = run_callback(adapter, {"metric": "lifeExp"})
        result = format_callback_response(response, adapter)
        for item in result.content:
            if item.type == "text":
                print(f"[text] {item.text[:200]}...")
            elif item.type == "image":
                print(f"[image] {item.mimeType}, {len(item.data)} chars base64")
        # update_chart: [text] JSON + [image] PNG
        # update_table: [text] JSON + [text] markdown table

[github-actions]

Thank you for your contribution to Dash! 🎉

This PR is exempt from requiring a linked issue due to its labels.

[camdecoster]

Looks good. I add a few minor suggestions.

[camdecoster]

Would using a dict instead of a list make more sense here? Then you wouldn't have to iterate through the list down below (assuming you could figure out which formatter to use before calling it).

[camdecoster]

Suggested change

	not isinstance(returned_output_value, list)
	or not returned_output_value
	not returned_output_value
	or not isinstance(returned_output_value, list)

[camdecoster]

Suggested change

	total = len(rows)
	total_rows = len(rows)

[camdecoster]

If wouldn't save you much, but you could avoid adding the outer |s and still comply with the markdown spec. But every token counts, right?

[camdecoster]

Why is this change necessary?

[camdecoster]

Since only TextContent is added below, could you remove ImageContent here?

[camdecoster]

Suggested change

	if not isinstance(returned_output_value, dict):
	if (
	not returned_output_value
	or not isinstance(returned_output_value, dict)
	):

[camdecoster]

Typical for this PR:

Suggested change

	"""Render the figure as a base64 PNG ImageContent.
	"""
	Render the figure as a base64 PNG ImageContent.