convez.ai
MCP ServerIntegração & APIsIntermediário
qiun

WebMCP Shop

qiun/webmcp-shop

Loja demo agente-ready com 7 ferramentas WebMCP para testes de automação

Ver no GitHub
InicialPluginScore · de 0 a 100

Loja online demo pronta para agentes IA navegarem e completarem compras end-to-end via WebMCP. Construída com Vite, React e TypeScript, expõe todas as funcionalidades (catálogo, produto, carrinho, checkout) como ferramentas MCP que agents podem operar autonomamente com confirmação humana.

Instalação

$npx convez-ai qiun/webmcp-shop

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Testar agentes IA em fluxos reais de e-commerce
  • Demonstrar WebMCP em browsers modernos (Chrome 146+)
  • Validar integração MCP-B polyfill com aplicações web
  • Prototipagem de automação de compras por agents

Veredito

Referência sólida e pronta para produção de site WebMCP-enabled. Ideal para quem está desenvolvendo agentes IA que precisam interagir com interfaces web reais, com suporte a human-in-the-loop em operações críticas como checkout.

README

A tradução para o português deste README ainda está na fila.

webmcp-shop

▶ Live demo: https://webmcp-shop.vercel.app

An online store — works normally for humans (catalog → product → cart → checkout) and exposes all of its features to AI agents via WebMCP. Every human action has an equivalent as a tool operating on the same logic (src/store/cart.ts).

Why this exists

This is one of four open demo sites built specifically to be agent-ready via WebMCP. We publish them so that anyone building AI browser agents — or working on the WebMCP standard and the MCP-B polyfill itself — has realistic, end-to-end targets to test against, not toy pages. The full shopping journey here (search the catalog, open a product, build a cart, check out) can be completed by a human in the UI and driven entirely by an AI agent through WebMCP tools, with human-in-the-loop confirmation on the order.

The goal is simple: make it easy to verify that an agent can really operate a WebMCP-enabled site, end to end. Fork it, point your agent at it, and see what works.

WebMCP demo set — live demos (source): acme · shop · stays · airline

Stack

  • Vite + React 18 + TypeScript (strict), react-router-dom
  • Tailwind CSS, lucide-react
  • zod + zod-to-json-schema (single source of truth for schema and validation)
  • MCP-B polyfill (@mcp-b/global); no backend — the cart lives in localStorage (webmcp-shop-cart)

Getting started

pnpm install
pnpm dev        # http://localhost:5173
pnpm build
pnpm lint
pnpm typecheck

WebMCP tools (7)

Toolread-onlydestructivehuman-in-loop
search_products✓––
get_product_details✓––
list_categories✓––
add_to_cart–––
update_cart_item–––
get_cart✓––
checkout–✓YES

checkout is registered only when the cart is non-empty (useWebMcpTool(checkoutTool, cart.count > 0)) and never finalizes an order without human confirmation (confirmWithUser → <ConfirmDialog/>).

How to test with an agent

  1. Native Chrome 146+: enable the WebMCP flag in chrome://flags, refresh — an agent (e.g. Gemini in Chrome / Model Context Tool Inspector) sees the page's tools.
  2. MCP-B polyfill (works today, any MCP agent): the page loads @mcp-b/global automatically. Start the @mcp-b/webmcp-local-relay bridge and connect any MCP agent.
  3. Smoke test:
    pnpm dev
    npx @mcp-b/webmcp-local-relay
    MCP_URL=http://localhost:8080/mcp node examples/agent-smoke-test.mjs
    
    It runs search_products → add_to_cart → get_cart → checkout.

API stability (June 2026)

WebMCP is a W3C Community Group Draft Report. Surface: document.modelContext.registerTool/ unregisterTool (navigator.modelContext deprecated since Chrome 150). API changes → you edit only src/lib/webmcp.ts. Changelog: developer.chrome.com/docs/ai/webmcp.

Deploy

Vercel / Netlify / GitHub Pages. SPA fallback to index.html. HTTPS required (secure context). Set Content-Type: application/json for /.well-known/webmcp.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados