Max Isbey
1b74b06753
Cut comment and docstring volume roughly in half across src, tests, examples, and docs_src: removed comments that restate the adjacent code, leftover development narration, section banners, and self-evident Args/Returns blocks, and compressed the remaining docstrings to a Google-style summary line plus only the detail that earns its place. Kept (and tightened) the load-bearing content: Raises sections, deprecation and version-availability notes, spec/RFC/issue references, why-comments for non-obvious decisions, and all coverage pragmas. The generated mcp_types.v* wire modules are untouched.
42 lines
1.4 KiB
Python
42 lines
1.4 KiB
Python
"""MCP Apps: a tool bound to a `ui://` resource the host renders as an interactive surface.
|
|
|
|
`Apps` is an opt-in extension: `@apps.tool(resource_uri=...)` stamps `_meta.ui.resourceUri` onto the tool,
|
|
`add_html_resource` registers the matching `ui://` HTML, and `client_supports_apps(ctx)` enables a
|
|
text-only fallback for clients that didn't negotiate Apps.
|
|
"""
|
|
|
|
from mcp.server.apps import Apps, client_supports_apps
|
|
from mcp.server.mcpserver import MCPServer
|
|
from mcp.server.mcpserver.context import Context
|
|
from stories._hosting import run_server_from_args
|
|
|
|
RESOURCE_URI = "ui://get-time/app.html"
|
|
CLOCK_HTML = """<!doctype html>
|
|
<title>Current time</title>
|
|
<h1 id="now">…</h1>
|
|
<script>
|
|
window.addEventListener("message", (event) => {
|
|
const text = event.data?.result?.content?.[0]?.text;
|
|
if (text) document.getElementById("now").textContent = text;
|
|
});
|
|
</script>
|
|
"""
|
|
|
|
|
|
def build_server() -> MCPServer:
|
|
apps = Apps()
|
|
|
|
@apps.tool(resource_uri=RESOURCE_URI, title="Get Time", description="Return the current time.")
|
|
def get_time(ctx: Context) -> str:
|
|
now = "2026-06-26T00:00:00Z"
|
|
if not client_supports_apps(ctx):
|
|
return f"The time is {now}."
|
|
return now
|
|
|
|
apps.add_html_resource(RESOURCE_URI, CLOCK_HTML, title="Clock")
|
|
return MCPServer("apps-example", extensions=[apps])
|
|
|
|
|
|
if __name__ == "__main__":
|
|
run_server_from_args(build_server)
|