convez.ai
MCP ServerIntegração & APIsAvançado
qiun

WebMCP Stays — Demo de Reserva de Hospedagem

qiun/webmcp-stays

Demo WebMCP: site de hospedagens totalmente operável por agentes IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Um servidor MCP que expõe um site de reserva de hospedagens (estilo Booking.com) como ferramentas para agentes IA. Demonstra implementação end-to-end de fluxo de reserva com validação de negócio, armazenamento local e confirmação com o usuário.

Instalação

$npx convez-ai qiun/webmcp-stays

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 de reserva realistas
  • Prototipagem de interfaces agent-ready com WebMCP
  • Validação de integração MCP em aplicações React/Vite

Veredito

Excelente referência técnica para quem constrói agentes de browser e estuda WebMCP. Código produção-ready (TypeScript strict, Zod) com 8 ferramentas cobrindo o fluxo completo de busca à confirmação de reserva — ideal para testes realistas, não brinquedos.

README

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

webmcp-stays

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

A Booking.com-style accommodation booking app — it works for humans (search → results → property → guest → confirmation) and exposes its features to AI agents via WebMCP. Every human action has an equivalent as a tool operating on the same logic (src/store/reservation.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 booking journey here (search a destination, filter results, open a property, pick a room, reserve) 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 reservation.

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
  • MCP-B polyfill (@mcp-b/global); no backend — reservation stored in localStorage (webmcp-stays-reservation)

Getting started

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

WebMCP tools (8)

Toolread-onlydestructivehuman-in-loop
search_destinations✓––
search_stays✓––
filter_stays✓––
get_property_details✓––
select_room–––
set_guest_details–––
get_reservation_summary✓––
reserve_stay–✓YES

Business validation with descriptive errors: adults>=1, rooms>=1, children's ages 0–17, total guests ≤ maxOccupancy × rooms, an adultsOnly property rejects reservations with children. reserve_stay is registered only once a room is selected and guest details are set; it requires human confirmation (confirmWithUser → <ConfirmDialog/>).

Mock data

  • src/data/destinations.ts: 22 destinations.
  • src/data/properties.ts: 44 properties (2 per destination), generated deterministically (the same inputs → the same data, for repeatable agent tests). Total price = pricePerNight × number of nights × number of rooms.

How to test with an agent

  1. Native Chrome 146+ with the WebMCP flag (chrome://flags).
  2. MCP-B polyfill (loaded by the adapter) + the @mcp-b/webmcp-local-relay bridge → Hermes / OpenClaw / your own 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
    
    Runs search_destinations → search_stays (2 adults + a 6-year-old child) → filter_stays → get_property_details → select_room → set_guest_details → reserve_stay.

API stability (June 2026)

WebMCP is a W3C Community Group Draft Report. For 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. Set Content-Type: application/json for /.well-known/webmcp.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados