WebMCP Demo Store

WebMCP 演示商店——单文件服务端、两种模式、一项基准测试

同一家商店、同一组工具、两种交付模式：

• WebMCP 模式——页面通过 MCP 工具调用公开商品目录（MCP-over-HTTP /mcp，以及 Chrome 原生的 document.modelContext），因此 Agent 只读取任务所需的内容。
• 普通模式——同一家商店作为普通网站运行；Agent 解析完整 HTML 页面，这也是目前每个 Agent 都必须采用的方式。

基准测试（150 件商品的目录，任务相同）：操作字节数减少 79%，输入 token 减少 42%，两种模式下的 8/8 项任务均正确完成。 DOM 模式在小型目录上表现更佳，随后迅速崩溃；WebMCP 则随着时间推移优势愈发明显。交叉点报告：report.html → WebMCP_Comparison_Report.pdf。

运行

python3 server.py                    # plain mode      → http://localhost:9501
MCP=1 PORT=9502 python3 server.py    # WebMCP mode     → http://localhost:9502 + /mcp

仅使用标准库（http.server、json、uuid、threading）——无需运行 pip install，无依赖项。

在线演示

• 普通模式：https://demonomcp.converso.work
• WebMCP：https://demowithmcp.converso.work（`.well-known/mcp` 发现端点，/mcp 端点）
• 启动资料包（演示文稿、白皮书、报告）：https://demowithmcp.converso.work/launch.html

Chrome 原生 WebMCP 测试（2026 年 10 月 13 日）

Chrome 154 + --enable-features=WebMCP 会在 HTTPS 来源中公开 document.modelContext（不包括 about:blank）。

• 通过 IMPERATIVE API（registerTool）注册了包含 5 个工具的商店契约：search_products、add_to_cart、get_cart、checkout（由服务端支持；所有 fetch 均在页面内完成）。
• 已验证标准客户端流程：通过 getTools() 发现工具 → 调用 executeTool() → 下单 1017/1018，T2/T4/T8 均挑选正确（HP Pavilion 14、Razer DeathAdder、OnePlus 12R）。
• 发现并解决了 154 版构建中的问题：
  1. executeTool(tool, args) 要求 args 为 JSON 字符串（对象形式会抛出 "Failed to parse input arguments"）；返回值也为 JSON 字符串——两端都要调用 JSON.parse。
  2. 工具不能使用相同名称重复注册（InvalidStateError）——重新加载页面即可重置。
  3. 标志/功能名称：无头模式下 --enable-features=WebMCP 有效；文档中的 chrome://flags/#enable-webmcp-testing 是手动设置路径。注意：API 为 document.modelContext（自 2026 年 7 月的构建版本起，已从 navigator 移出）。
• 要点：该演示的工具契约兼容 Chrome 原生 WebMCP，而不仅是我们的 JSON-RPC 适配层。Chrome 发布客户端 Agent（Gemini-in-Chrome）后，这家商店便已做好迎接 Agent 的准备。

仓库布局

路径	内容
server.py	完整实现：商店 + 购物车 + 订单 + MCP 传输（MCP=1）+ 静态内容/报告服务
catalog.json / catalog_10.json	150 件商品 / 10 件商品的演示目录
compare.py、compare_llm.py、browser_llm.py	基准测试工具（DOM 模式 Agent、LLM token 统计、浏览器原生流程）
make_report.py	从 results.json / agg_150_vs_30.json 重新生成 HTML/PDF 报告
whitepaper.html、report*.html、*.pdf、chart_*.png	策略与证据资料（包含启动演示文稿）
weekly_recap.py	计数器 + 实时 URL 摘要（供运维 cron 使用）

许可证

MIT。