Skip to content

πŸš€ The fast, Pythonic way to build MCP servers and clients.

Add MCP message inspector to dev apps UI (#3570)

Jeremiah Lowin85faad59a159
diff --git a/examples/apps/inspector_demo.py b/examples/apps/inspector_demo.py
new file mode 100644
index 000000000..2d5d244bc
--- /dev/null
+++ b/examples/apps/inspector_demo.py
@@ -0,0 +1,120 @@
+"""Demo server for testing the dev apps MCP message inspector.
+
+Exercises tool calls, server notifications (ctx.log), and errors
+so you can verify all message types appear in the inspector panel.
+
+Usage:
+ fastmcp dev apps examples/apps/inspector_demo.py
+"""
+
+from __future__ import annotations
+
+from prefab_ui.actions import ShowToast
+from prefab_ui.actions.mcp import CallTool, SendMessage, UpdateContext
+from prefab_ui.components import (
+ Badge,
+ Button,
+ Column,
+ Heading,
+ Muted,
+ Row,
+)
+from prefab_ui.rx import ERROR
+
+from fastmcp import FastMCP
+from fastmcp.server.context import Context
+
+mcp = FastMCP("Inspector Demo")
+
+
+def demo() -> Column:
+ """A demo app that exercises various MCP message types."""
+ with Column(gap=6, css_class="p-8 max-w-lg") as view:
+ Heading("Inspector Demo")
+ Muted("Click the buttons and watch the inspector panel on the right.")
+
+ with Column(gap=3):
+ with Row(gap=2, align="center"):
+ Button(
+ "Call Tool",
+ variant="default",
+ on_click=CallTool(
+ "echo",
+ arguments={"message": "Hello from the inspector!"},
+ on_success=ShowToast("Tool call succeeded", variant="success"),
+ on_error=ShowToast(ERROR, variant="error"),
+ ),
+ )
+ Badge("tools/call + response", variant="secondary")
+
+ with Row(gap=2, align="center"):
+ Button(
+ "Call with Logging",
+ variant="default",
+ on_click=CallTool(
+ "echo_with_logs",
+ arguments={"message": "Watch the notifications!"},
+ on_success=ShowToast("Done (check logs)", variant="success"),
+ on_error=ShowToast(ERROR, variant="error"),
+ ),
+ )
+ Badge("tools/call + notifications", variant="secondary")
+
+ with Row(gap=2, align="center"):
+ Button(
+ "Trigger Error",
+ variant="destructive",
+ on_click=CallTool(
+ "fail",
+ arguments={},
+ on_error=ShowToast(ERROR, variant="error"),
+ ),
+ )
+ Badge("error response", variant="destructive")
+
+ with Row(gap=2, align="center"):
+ Button(
+ "Update Context",
+ variant="outline",
+ on_click=[
+ UpdateContext(content="Demo context from inspector"),
+ ShowToast("Context updated", variant="success"),
+ ],
+ )
+ Badge("bridge: UpdateContext", variant="outline")
+
+ with Row(gap=2, align="center"):
+ Button(
+ "Send Message",
+ variant="outline",
+ on_click=SendMessage("Tell me about this demo app"),
+ )
+ Badge("bridge: SendMessage", variant="outline")
+
+ return view
+
+
+def echo(message: str) -> str:
+ """Echo a message back."""
+ return f"Echo: {message}"
+
+
+async def echo_with_logs(message: str, ctx: Context) -> str:
+ """Echo a message and emit log notifications."""
+ await ctx.log(f"Processing: {message}", level="info")
+ await ctx.log("Step 1: validated input", level="debug")
+ await ctx.log("Step 2: generating response", level="debug")
+ return f"Logged echo: {message}"
+
+
+def fail() -> str:
+ """Always raises an error."""
+ raise ValueError("This is a deliberate error for testing the inspector")
+
+
+if __name__ == "__main__":
+ mcp.run()
diff --git a/src/fastmcp/cli/apps_dev.py b/src/fastmcp/cli/apps_dev.py
index b05578ec9..8e7cc65fb 100644
--- a/src/fastmcp/cli/apps_dev.py
+++ b/src/fastmcp/cli/apps_dev.py
@@ -35,6 +35,7 @@ import signal
import sys
import tarfile
import tempfile
+import time
import urllib.request
import webbrowser
from pathlib import Path
@@ -53,6 +54,124 @@ from fastmcp.utilities.logging import get_logger
logger = get_logger(__name__)
+
+# ---------------------------------------------------------------------------
+# MCP message log (captures proxy traffic for the dev UI log panel)
+# ---------------------------------------------------------------------------
+
+
+class _MessageLog:
+ """In-memory buffer of MCP JSON-RPC messages flowing through the proxy."""
+
+ def __init__(self) -> None:
+ self._entries: list[dict[str, Any]] = []
+ self._counter = 0
+ self._request_methods: dict[int | str, str] = {}
+ self._request_times: dict[int | str, float] = {}
+
+ def log_request(self, body: dict[str, Any]) -> None:
+ method = body.get("method", "unknown")
+ jsonrpc_id = body.get("id")
+ timestamp = time.time()
+ if jsonrpc_id is not None:
+ self._request_methods[jsonrpc_id] = method
+ self._request_times[jsonrpc_id] = timestamp
+ self._counter += 1
+ self._entries.append(
+ {
+ "id": self._counter,
+ "timestamp": timestamp,
+ "direction": "request",
+ "method": method,
+ "body": body,
+ }
+ )
+
+ def log_response(self, body: dict[str, Any]) -> None:
+ # Server-initiated notifications have "method" but no "id"
+ if "method" in body and "id" not in body:
+ self._counter += 1
+ self._entries.append(
+ {
+ "id": self._counter,
+ "timestamp": time.time(),
+ "direction": "notification",
+ "method": body.get("method", "unknown"),
+ "body": body,
+ }
+ )
+ return
+
+ jsonrpc_id = body.get("id")
+ method = (
+ self._request_methods.pop(jsonrpc_id, None)
+ if jsonrpc_id is not None
+ else None
+ )
+ request_time = (
+ self._request_times.pop(jsonrpc_id, None)
+ if jsonrpc_id is not None
+ else None
+ )
+ timestamp = time.time()
+ duration_ms = (
+ round((timestamp - request_time) * 1000, 1) if request_time else None
+ )
+ self._counter += 1
+ self._entries.append(
+ {
+ "id": self._counter,
+ "timestamp": timestamp,
+ "direction": "response",
+ "method": method,
+ "body": body,
+ "duration_ms": duration_ms,
+ }
+ )
+
+ def get_since(self, since_id: int = 0) -> list[dict[str, Any]]:
+ return [e for e in self._entries if e["id"] > since_id]
+
+ def log_bridge(self, body: dict[str, Any]) -> None:
+ method = body.get("method", "unknown")
+ self._counter += 1
+ self._entries.append(
+ {
+ "id": self._counter,
+ "timestamp": time.time(),
+ "direction": "bridge",
+ "method": method,
+ "body": body,
+ }
+ )
+
+ def clear(self) -> None:
+ self._entries.clear()
+ self._request_methods.clear()
+ self._request_times.clear()
+
+
+def _log_response_bytes(log: _MessageLog, raw: bytes, content_type: str) -> None:
+ """Parse accumulated proxy response bytes and log as message entries."""
+ if not raw:
+ return
+ try:
+ if "text/event-stream" in content_type:
+ for line in raw.decode("utf-8", errors="replace").splitlines():
+ if line.startswith("data: "):
+ with contextlib.suppress(json.JSONDecodeError):
+ log.log_response(json.loads(line[6:]))
+ else:
+ body = json.loads(raw)
+ if isinstance(body, list):
+ for item in body:
+ log.log_response(item)
+ else:
+ log.log_response(body)
+ except (json.JSONDecodeError, TypeError):
+ pass
+
+
_EXT_APPS_VERSION = "1.0.1"
# Pin to the SDK version ext-apps 1.0.1 was compiled against so the client
# and transport modules are API-compatible with the app-bridge internals.
@@ -280,6 +399,451 @@ _HOST_HTML_TEMPLATE = """\
</html>
"""
+# ---------------------------------------------------------------------------
+# Dev log panel (injected into host pages)
+# ---------------------------------------------------------------------------
+
+_LOG_PANEL_HTML = """\
+<style>
+ #mcp-log-panel {
+ position: fixed; top: 0; left: 0; bottom: 0; width: 360px;
+ z-index: 10000;
+ font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, monospace;
+ font-size: 12px; background: #1e1e2e; color: #cdd6f4;
+ border-right: 1px solid #45475a;
+ display: flex; flex-direction: column;
+ }
+ #mcp-log-panel.hidden { display: none; }
+ #app-frame {
+ width: calc(100% - 360px) !important; height: 100% !important;
+ margin-left: 360px !important;
+ }
+ #mcp-log-resize {
+ position: absolute; right: -3px; top: 0; bottom: 0; width: 6px;
+ cursor: col-resize; z-index: 1;
+ }
+ #mcp-log-resize:hover, #mcp-log-resize.active { background: #585b70; }
+ #mcp-log-header {
+ display: flex; justify-content: space-between; align-items: center;
+ padding: 10px 12px; background: #181825;
+ border-bottom: 1px solid #45475a; flex-shrink: 0;
+ }
+ #mcp-log-brand {
+ display: flex; align-items: center; gap: 8px;
+ }
+ #mcp-log-brand svg { flex-shrink: 0; }
+ #mcp-log-brand-text {
+ font-weight: 700; font-size: 13px; color: #cdd6f4;
+ letter-spacing: -0.3px;
+ }
+ #mcp-log-count-badge {
+ font-size: 11px; color: #6c7086; font-weight: 400;
+ }
+ #mcp-log-actions { display: flex; gap: 6px; }
+ #mcp-log-actions button {
+ background: #313244; color: #cdd6f4; border: 1px solid #45475a;
+ padding: 2px 8px; border-radius: 3px; cursor: pointer;
+ font-size: 11px; font-family: inherit;
+ }
+ #mcp-log-actions button:hover { background: #45475a; }
+ #mcp-log-entries { flex: 1; overflow-y: auto; }
+ .log-entry {
+ padding: 6px 12px; border-bottom: 1px solid #232334; cursor: pointer;
+ }
+ .log-entry:hover { background: #313244; }
+ .log-entry.error { background: rgba(243, 139, 168, 0.08); }
+ .log-entry.error:hover { background: rgba(243, 139, 168, 0.14); }
+ .log-entry.error .log-method { color: #f38ba8; }
+ .log-primary {
+ display: flex; justify-content: space-between;
+ align-items: baseline; gap: 8px;
+ }
+ .log-left {
+ display: flex; gap: 6px; align-items: baseline; min-width: 0;
+ }
+ .log-dir { flex-shrink: 0; }
+ .log-dir.request { color: #89b4fa; }
+ .log-dir.response { color: #a6e3a1; }
+ .log-dir.error { color: #f38ba8; }
+ .log-dir.bridge { color: #cba6f7; }
+ .log-dir.notification { color: #fab387; }
+ .log-method {
+ color: #f9e2af; font-weight: 600;
+ white-space: nowrap; overflow: hidden; text-overflow: ellipsis;
+ }
+ .log-meta { color: #6c7086; font-size: 11px; white-space: nowrap; flex-shrink: 0; }
+ .log-subtitle {
+ color: #a6adc8; font-size: 11px; padding-left: 22px;
+ overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+ margin-top: 1px;
+ }
+ .log-detail {
+ display: none; padding: 8px 12px 4px 22px; background: #11111b;
+ white-space: pre-wrap; word-break: break-all;
+ color: #bac2de; font-size: 11px; line-height: 1.4;
+ margin-top: 4px; border-radius: 4px;
+ }
+ .log-entry.expanded .log-detail { display: block; }
+ @keyframes log-flash {
+ from { background: rgba(137, 180, 250, 0.22); }
+ to { background: transparent; }
+ }
+ @keyframes log-flash-error {
+ from { background: rgba(243, 139, 168, 0.25); }
+ to { background: rgba(243, 139, 168, 0.08); }
+ }
+ .log-entry.new { animation: log-flash 2s ease-out; }
+ .log-entry.error.new { animation: log-flash-error 2s ease-out; }
+ .log-copy {
+ opacity: 0; transition: opacity 0.15s;
+ background: #313244; color: #a6adc8; border: 1px solid #45475a;
+ padding: 1px 6px; border-radius: 3px; cursor: pointer;
+ font-size: 10px; font-family: inherit; flex-shrink: 0;
+ }
+ .log-entry:hover .log-copy { opacity: 1; }
+ .log-copy:hover { background: #45475a; color: #cdd6f4; }
+ #mcp-log-open {
+ position: fixed; bottom: 12px; left: 12px; z-index: 10000;
+ background: #181825; color: #cdd6f4; border: 1px solid #45475a;
+ padding: 6px 12px; border-radius: 6px; cursor: pointer;
+ font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, monospace;
+ font-size: 11px; display: none;
+ }
+ #mcp-log-open:hover { background: #313244; }
+ #mcp-log-filters {
+ display: flex; gap: 8px; align-items: center;
+ padding: 6px 12px; border-bottom: 1px solid #45475a; flex-shrink: 0;
+ }
+ .log-seg {
+ display: inline-flex; border: 1px solid #45475a; border-radius: 6px;
+ overflow: hidden;
+ }
+ .log-seg button {
+ background: transparent; color: #6c7086; border: none;
+ border-right: 1px solid #45475a; padding: 3px 10px; cursor: pointer;
+ font-size: 10px; font-family: inherit; transition: all 0.15s;
+ }
+ .log-seg button:last-child { border-right: none; }
+ .log-seg button:hover { background: rgba(205, 214, 244, 0.06); }
+ .log-seg button.active[data-filter="tools"] { background: rgba(137, 180, 250, 0.15); color: #89b4fa; }
+ .log-seg button.active[data-filter="notifications"] { background: rgba(250, 179, 135, 0.15); color: #fab387; }
+ .log-seg button.active[data-filter="bridge"] { background: rgba(203, 166, 247, 0.15); color: #cba6f7; }
+ .log-seg button.active[data-filter="errors"] { background: rgba(243, 139, 168, 0.15); color: #f38ba8; }
+ #mcp-log-filters-label {
+ font-size: 9px; color: #6c7086; text-transform: uppercase;
+ letter-spacing: 0.5px; font-weight: 600;
+ }
+ #mcp-log-level-select {
+ background: #313244; color: #cdd6f4; border: 1px solid #45475a;
+ border-radius: 6px; padding: 3px 8px; cursor: pointer;
+ font-size: 10px; font-family: inherit;
+ }
+ #mcp-log-level-select option { background: #1e1e2e; }
+ .log-level {
+ font-size: 9px; padding: 0 5px; border-radius: 3px;
+ font-weight: 600; text-transform: uppercase; letter-spacing: 0.3px;
+ flex-shrink: 0; line-height: 16px;
+ }
+ .log-level-debug { background: #313244; color: #6c7086; }
+ .log-level-info { background: rgba(137, 180, 250, 0.15); color: #89b4fa; }
+ .log-level-warning { background: rgba(249, 226, 175, 0.15); color: #f9e2af; }
+ .log-level-error { background: rgba(243, 139, 168, 0.15); color: #f38ba8; }
+ .log-level-notice { background: rgba(148, 226, 213, 0.15); color: #94e2d5; }
+ .log-level-critical { background: rgba(243, 139, 168, 0.2); color: #f38ba8; }
+ .log-level-alert { background: rgba(243, 139, 168, 0.25); color: #f38ba8; }
+ .log-level-emergency { background: rgba(243, 139, 168, 0.3); color: #f38ba8; }
+</style>
+<div id="mcp-log-panel">
+ <div id="mcp-log-resize"></div>
+ <div id="mcp-log-header">
+ <div id="mcp-log-brand">
+ <svg width="20" height="20" viewBox="0 0 196 196" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M145.747 44.611L145.355 44.3877L144.96 44.611L86.0283 78.5276V171.267L86.4014 171.499L99.6674 179.667V86.3859L159 52.2379L145.747 44.611Z" fill="#cdd6f4"/><path d="M121.616 30.2714L121.224 30.0454L120.832 30.2714L61.8975 64.188V156.928L62.2732 157.156L75.5393 165.325V72.0463L134.869 37.8983L121.616 30.2714Z" fill="#cdd6f4"/><path d="M97.4894 16.3818L97.0973 16.1558L96.7025 16.3818L37.7705 50.3038V142.066L51.4096 150.463V58.1567L110.742 24.0086L97.4894 16.3818Z" fill="#cdd6f4"/><path d="M131.23 113.671L124.979 117.266L124.584 117.494V117.5L116.796 121.987L110.547 125.581L110.152 125.807V141.51L144.564 121.709V121.698L158.999 113.394V97.6851L139.277 109.034L131.23 113.671Z" fill="#cdd6f4"/></svg>
+ <span id="mcp-log-brand-text">FastMCP Apps</span>
+ <span id="mcp-log-count-badge">\u00b7 <span id="mcp-log-count">0</span></span>
+ </div>
+ <div id="mcp-log-actions">
+ <button id="mcp-log-clear">Clear</button>
+ <button id="mcp-log-close">\u00d7</button>
+ </div>
+ </div>
+ <div id="mcp-log-filters">
+ <span id="mcp-log-filters-label">Show</span>
+ <div class="log-seg">
+ <button class="active" data-filter="tools">Tools</button>
+ <button class="active" data-filter="notifications">Logs</button>
+ <button class="active" data-filter="bridge">Host</button>
+ <button class="active" data-filter="errors">Errors</button>
+ </div>
+ <select id="mcp-log-level-select">
+ <option value="debug">Debug+</option>
+ <option value="info">Info+</option>
+ <option value="warning">Warn+</option>
+ <option value="error">Error+</option>
+ <option value="critical">Critical+</option>
+ </select>
+ </div>
+ <div id="mcp-log-entries"></div>
+</div>
+<button id="mcp-log-open">MCP Log</button>
+<script>
+(function() {
+ var lastId = 0, totalCount = 0, panelWidth = 360;
+ var panel = document.getElementById("mcp-log-panel");
+ var entries = document.getElementById("mcp-log-entries");
+ var countEl = document.getElementById("mcp-log-count");
+ var openBtn = document.getElementById("mcp-log-open");
+ var resizeHandle = document.getElementById("mcp-log-resize");
+
+ function setFrameLayout(w) {
+ var frame = document.getElementById("app-frame");
+ if (!frame) return;
+ frame.style.setProperty("width", w, "important");
+ frame.style.setProperty("margin-left", w === "100%" ? "0" : panelWidth + "px", "important");
+ }
+
+ document.getElementById("mcp-log-close").addEventListener("click", function() {
+ panel.classList.add("hidden");
+ openBtn.style.display = "block";
+ setFrameLayout("100%");
+ });
+
+ openBtn.addEventListener("click", function() {
+ panel.classList.remove("hidden");
+ openBtn.style.display = "none";
+ setFrameLayout("calc(100% - " + panelWidth + "px)");
+ });
+
+ resizeHandle.addEventListener("mousedown", function(e) {
+ e.preventDefault();
+ resizeHandle.classList.add("active");
+ var frame = document.getElementById("app-frame");
+ if (frame) frame.style.pointerEvents = "none";
+ document.addEventListener("mousemove", onResize);
+ document.addEventListener("mouseup", stopResize);
+ });
+
+ function onResize(e) {
+ var w = Math.max(200, Math.min(e.clientX, window.innerWidth * 0.8));
+ panelWidth = w;
+ panel.style.width = w + "px";
+ setFrameLayout("calc(100% - " + w + "px)");
+ }
+
+ function stopResize() {
+ resizeHandle.classList.remove("active");
+ var frame = document.getElementById("app-frame");
+ if (frame) frame.style.pointerEvents = "";
+ document.removeEventListener("mousemove", onResize);
+ document.removeEventListener("mouseup", stopResize);
+ }
+
+ document.getElementById("mcp-log-clear").addEventListener("click", function() {
+ entries.innerHTML = "";
+ totalCount = 0;
+ countEl.textContent = "0";
+ fetch("/api/logs/clear", { method: "POST" });
+ });
+
+ var activeFilters = {tools: true, notifications: true, bridge: true, errors: true};
+ var levelOrder = ["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"];
+ var minLevel = 0;
+
+ document.getElementById("mcp-log-filters").addEventListener("click", function(e) {
+ var btn = e.target.closest("[data-filter]");
+ if (!btn) return;
+ var f = btn.dataset.filter;
+ activeFilters[f] = !activeFilters[f];
+ btn.classList.toggle("active", activeFilters[f]);
+ applyFilters();
+ });
+
+ document.getElementById("mcp-log-level-select").addEventListener("change", function(e) {
+ minLevel = levelOrder.indexOf(e.target.value);
+ applyFilters();
+ });
+
+ function shouldShow(el) {
+ var cat = el.dataset.category || "";
+ if (activeFilters[cat] === false) return false;
+ var lv = el.dataset.level;
+ if (lv && levelOrder.indexOf(lv) < minLevel) return false;
+ return true;
+ }
+
+ function applyFilters() {
+ var items = entries.querySelectorAll(".log-entry");
+ for (var i = 0; i < items.length; i++) {
+ items[i].style.display = shouldShow(items[i]) ? "" : "none";
+ }
+ }
+
+ function summarize(entry) {
+ var b = entry.body;
+ if (!b) return "";
+ if (entry.direction === "request" || entry.direction === "notification") {
+ if (b.method === "tools/call" && b.params) return b.params.name || "";
+ if (b.method === "resources/read" && b.params) return b.params.uri || "";
+ if (b.method === "notifications/message" && b.params) {
+ var d = b.params.data;
+ if (d && typeof d === "object") return d.msg || d.message || JSON.stringify(d);
+ return d || b.params.level || "";
+ }
+ return "";
+ }
+ if (b.error) return "error: " + (b.error.message || JSON.stringify(b.error));
+ if (b.result && typeof b.result === "object") {
+ if (Array.isArray(b.result.tools)) return b.result.tools.length + " tools";
+ if (Array.isArray(b.result.resources)) return b.result.resources.length + " resources";
+ if (Array.isArray(b.result.prompts)) return b.result.prompts.length + " prompts";
+ if (b.result.content) {
+ var first = b.result.content[0];
+ if (first && first.text) {
+ return first.text.length > 60 ? first.text.slice(0, 60) + "\u2026" : first.text;
+ }
+ return b.result.content.length + " content item(s)";
+ }
+ }
+ return "";
+ }
+
+ function formatTime(ts) {
+ var d = new Date(ts * 1000);
+ return String(d.getHours()).padStart(2, "0") + ":"
+ + String(d.getMinutes()).padStart(2, "0") + ":"
+ + String(d.getSeconds()).padStart(2, "0");
+ }
+
+ function renderEntry(entry) {
+ var div = document.createElement("div");
+ var isError = entry.direction === "response" && entry.body
+ && (entry.body.error || (entry.body.result && entry.body.result.isError));
+ div.className = "log-entry" + (isError ? " error" : "");
+ var dirClass = isError ? "error" : entry.direction;
+ var arrows = {request: "\u2192", response: "\u2190", bridge: "\u2191", notification: "\u2193"};
+
+ // Categorize for filtering
+ if (isError) div.dataset.category = "errors";
+ else if (entry.direction === "bridge") div.dataset.category = "bridge";
+ else if (entry.direction === "notification") div.dataset.category = "notifications";
+ else div.dataset.category = "tools";
+
+ var primary = document.createElement("div");
+ primary.className = "log-primary";
+
+ var left = document.createElement("div");
+ left.className = "log-left";
+
+ var dirEl = document.createElement("span");
+ dirEl.className = "log-dir " + dirClass;
+ dirEl.textContent = arrows[entry.direction] || "\u2190";
+
+ var methodEl = document.createElement("span");
+ methodEl.className = "log-method";
+ methodEl.textContent = entry.method || "";
+
+ left.appendChild(dirEl);
+ left.appendChild(methodEl);
+
+ // Log level badge for notifications
+ if (entry.direction === "notification" && entry.body && entry.body.params) {
+ var level = (entry.body.params.level || "").toLowerCase();
+ if (level) {
+ div.dataset.level = level;
+ var lvl = document.createElement("span");
+ lvl.className = "log-level log-level-" + level;
+ lvl.textContent = level;
+ left.appendChild(lvl);
+ }
+ }
+
+ var metaEl = document.createElement("span");
+ metaEl.className = "log-meta";
+ metaEl.textContent = entry.duration_ms != null
+ ? entry.duration_ms + "ms"
+ : formatTime(entry.timestamp);
+
+ var copyBtn = document.createElement("button");
+ copyBtn.className = "log-copy";
+ copyBtn.textContent = "Copy";
+ copyBtn.addEventListener("click", function(e) {
+ e.stopPropagation();
+ navigator.clipboard.writeText(JSON.stringify(entry.body, null, 2));
+ copyBtn.textContent = "Copied";
+ setTimeout(function() { copyBtn.textContent = "Copy"; }, 1000);
+ });
+
+ primary.appendChild(left);
+ primary.appendChild(metaEl);
+ primary.appendChild(copyBtn);
+ div.appendChild(primary);
+
+ var summary = summarize(entry);
+ if (summary) {
+ var subtitle = document.createElement("div");
+ subtitle.className = "log-subtitle";
+ subtitle.textContent = summary;
+ div.appendChild(subtitle);
+ }
+
+ var detail = document.createElement("div");
+ detail.className = "log-detail";
+ detail.textContent = JSON.stringify(entry.body, null, 2);
+ div.appendChild(detail);
+
+ div.addEventListener("click", function() { div.classList.toggle("expanded"); });
+ return div;
+ }
+
+ var polling = false;
+ function poll() {
+ if (polling) return;
+ polling = true;
+ fetch("/api/logs?since=" + lastId)
+ .then(function(r) { return r.ok ? r.json() : []; })
+ .then(function(data) {
+ if (!data || !data.length) return;
+ lastId = data[data.length - 1].id;
+ totalCount += data.length;
+ countEl.textContent = String(totalCount);
+ var atBottom = entries.scrollHeight - entries.scrollTop - entries.clientHeight < 40;
+ for (var i = 0; i < data.length; i++) {
+ var el = renderEntry(data[i]);
+ el.classList.add("new");
+ if (!shouldShow(el)) el.style.display = "none";
+ entries.appendChild(el);
+ }
+ if (atBottom) entries.scrollTop = entries.scrollHeight;
+ })
+ .catch(function() {})
+ .finally(function() { polling = false; });
+ }
+
+ window.addEventListener("message", function(event) {
+ var data = event.data;
+ if (typeof data === "string") {
+ try { data = JSON.parse(data); } catch(e) { return; }
+ }
+ if (!data || typeof data !== "object") return;
+ if (!data.jsonrpc && !data.method) return;
+ fetch("/api/logs/bridge", {
+ method: "POST",
+ headers: {"Content-Type": "application/json"},
+ body: JSON.stringify({body: data})
+ });
+ });
+
+ setInterval(poll, 500);
+ poll();
+})();
+</script>
+"""
+
+
+def _inject_log_panel(html: str) -> str:
+ """Inject the MCP message log panel before </body>."""
+ return html.replace("</body>", _LOG_PANEL_HTML + "\n</body>")
+
+
# ---------------------------------------------------------------------------
# Picker UI (Prefab-based, built in Python)
# ---------------------------------------------------------------------------
@@ -373,11 +937,11 @@ def _build_picker_html(tools: list[dict[str, Any]]) -> str:
if not tools:
with Column(gap=4, css_class="p-6 max-w-2xl mx-auto") as view:
- Heading("FastMCP App Preview")
+ Heading("FastMCP Apps")
Muted(
"No UI tools found on this server. Use @app.ui() to register entry-point tools."
)
- return PrefabApp(title="FastMCP App Preview", view=view).html()
+ return PrefabApp(title="FastMCP Apps", view=view).html()
first_name: str = tools[0]["name"]
@@ -385,7 +949,7 @@ def _build_picker_html(tools: list[dict[str, Any]]) -> str:
return tool.get("title") or tool["name"]
with Column(gap=6, css_class="p-8 max-w-lg mx-auto") as view:
- Heading("FastMCP App Preview")
+ Heading("FastMCP Apps")
if len(tools) > 1:
with Column(gap=1):
@@ -437,7 +1001,7 @@ def _build_picker_html(tools: list[dict[str, Any]]) -> str:
css_class="text-xs text-muted-foreground text-right",
)
- return PrefabApp(title="FastMCP App Preview", view=view).html()
+ return PrefabApp(title="FastMCP Apps", view=view).html()
# ---------------------------------------------------------------------------
@@ -607,13 +1171,14 @@ def _make_dev_app(
mcp_url: str,
app_bridge_js: str,
import_map_tag: str,
+ message_log: _MessageLog,
) -> Starlette:
"""Build the Starlette dev server application."""
async def picker(request: Request) -> HTMLResponse:
"""AppBridge host page β€” loads the picker app in an iframe and wires the bridge."""
host_html = _HOST_SHELL.format(
- title="FastMCP App Preview",
+ title="FastMCP Apps",
import_map_tag=import_map_tag,
status_text="",
status_display="none",
@@ -623,7 +1188,7 @@ def _make_dev_app(
on_open_link="bridge.onopenlink = async ({ url }) => { window.location.href = url; return {}; };",
on_initialized="bridge.oninitialized = async () => {};",
)
- return HTMLResponse(host_html)
+ return HTMLResponse(_inject_log_panel(host_html))
async def picker_app(request: Request) -> HTMLResponse:
"""Prefab picker UI β€” tool list with one tab per UI tool."""
@@ -648,7 +1213,7 @@ def _make_dev_app(
tool_args_json=json.dumps(tool_args),
mcp_sdk_version=_MCP_SDK_VERSION,
)
- return HTMLResponse(host_html)
+ return HTMLResponse(_inject_log_panel(host_html))
async def api_launch(request: Request) -> Response:
"""Picker form submits here; returns a /launch URL string for OpenLink."""
@@ -690,6 +1255,20 @@ def _make_dev_app(
async def proxy_mcp(request: Request) -> Response:
"""Proxy all MCP requests to the user's server (avoids browser CORS)."""
body = await request.body()
+
+ # Log MCP requests
+ if body and request.method == "POST":
+ try:
+ req_json = json.loads(body)
+ if isinstance(req_json, list):
+ for item in req_json:
+ if isinstance(item, dict):
+ message_log.log_request(item)
+ elif isinstance(req_json, dict):
+ message_log.log_request(req_json)
+ except (json.JSONDecodeError, TypeError):
+ pass
+
headers = {
k: v
for k, v in request.headers.items()
@@ -699,9 +1278,29 @@ def _make_dev_app(
client = httpx.AsyncClient(timeout=None)
async def _stream_and_cleanup(resp: httpx.Response) -> Any:
+ is_sse = "text/event-stream" in resp.headers.get("content-type", "")
+ buf: list[bytes] = []
+ sse_buf = ""
try:
async for chunk in resp.aiter_bytes():
yield chunk
+ if is_sse:
+ # Parse SSE events incrementally
+ sse_buf += chunk.decode("utf-8", errors="replace")
+ while "\r\n\r\n" in sse_buf or "\n\n" in sse_buf:
+ # Split on whichever double-newline appears first
+ ri = sse_buf.find("\r\n\r\n")
+ ni = sse_buf.find("\n\n")
+ if ri >= 0 and (ni < 0 or ri < ni):
+ event, sse_buf = sse_buf[:ri], sse_buf[ri + 4 :]
+ else:
+ event, sse_buf = sse_buf[:ni], sse_buf[ni + 2 :]
+ for line in event.splitlines():
+ if line.startswith("data: "):
+ with contextlib.suppress(json.JSONDecodeError):
+ message_log.log_response(json.loads(line[6:]))
+ else:
+ buf.append(chunk)
except (
httpx.RemoteProtocolError,
httpx.ReadError,
@@ -709,6 +1308,9 @@ def _make_dev_app(
):
pass # Connection closed during shutdown β€” not an error
finally:
+ # Log non-SSE responses (JSON) after stream completes
+ if buf:
+ _log_response_bytes(message_log, b"".join(buf), "application/json")
with contextlib.suppress(Exception):
await resp.aclose()
with contextlib.suppress(Exception):
@@ -750,12 +1352,35 @@ def _make_dev_app(
media_type="application/json",
)
+ async def api_logs(request: Request) -> Response:
+ """Return message log entries since a given id."""
+ since = int(request.query_params.get("since", "0"))
+ entries = message_log.get_since(since)
+ return Response(
+ content=json.dumps(entries),
+ media_type="application/json",
+ )
+
+ async def api_logs_bridge(request: Request) -> Response:
+ """Log a bridge message (postMessage between app iframe and host)."""
+ data = await request.json()
+ message_log.log_bridge(data.get("body", data))
+ return Response(content="{}", media_type="application/json")
+
+ async def api_logs_clear(request: Request) -> Response:
+ """Clear the message log."""
+ message_log.clear()
+ return Response(content="{}", media_type="application/json")
+
return Starlette(
routes=[
Route("/", picker),
Route("/picker-app", picker_app),
Route("/launch", launch),
Route("/api/launch", api_launch, methods=["POST"]),
+ Route("/api/logs", api_logs),
+ Route("/api/logs/bridge", api_logs_bridge, methods=["POST"]),
+ Route("/api/logs/clear", api_logs_clear, methods=["POST"]),
Route("/ui-resource", ui_resource),
Route("/js/app-bridge.js", serve_app_bridge_js),
Route(
@@ -864,7 +1489,7 @@ async def run_dev_apps(
logger.info(f"FastMCP dev UI at {dev_url}")
- dev_app = _make_dev_app(mcp_url, app_bridge_js, import_map_tag)
+ dev_app = _make_dev_app(mcp_url, app_bridge_js, import_map_tag, _MessageLog())
config = uvicorn.Config(
dev_app,
host="localhost",