hotels-mcp

About

Description:
A secure, production‑ready Cloudflare Worker API integrating Hotels.com search and booking via RapidAPI, optimized for use with Claude Desktop through MCP. It emphasizes type safety, robust error handling, clear observability, and strict secret management suitable for real-world deployment.

Website:
https://github.com/corneyc/hotels-mcp

Topics:
cloudflare-workers, typescript, rapidapi, hotels-api, mcp, azure, api-integration, security, type-safety, wrangler, claude, notion, documentation

---

Features

• Runtime: Cloudflare Workers with Wrangler-generated runtime types for end-to-end type safety.
• Hotels.com integration: RapidAPI-backed endpoints for search/regions suitable for MCP agents and external clients.
• Security: Secrets via environment variables; no hard-coded credentials; production secrets via wrangler secret put.
• Developer experience: Unified Env types across Worker and tests; concise handlers; focused utility modules.
• Resilience: Timeout and conditional retry pattern; clear 4xx/5xx propagation; friendly JSON errors.
• Cross-platform: Smooth workflow on macOS and Ubuntu, interoperable with Azure-hosted services.
• Documentation: Notion workspace for architecture, runbooks, and troubleshooting.

---

Notion Integration

This project uses a linked Notion workspace for central documentation.

• Architecture: Diagrams, component ownership, and data flow notes.
• API notes: Endpoint specs, response shapes, and quota/rate-limit references.
• Deployment: Checklists, rollback steps, and verification procedures.
• Troubleshooting: Known issues, root-cause logs, and remediations.

If you have access, use your team’s Notion link here:

• Notion workspace:

---

Prerequisites

• Node.js: v18+
• Package manager: pnpm or npm
• Wrangler CLI: Latest v4.x
• RapidAPI: Active subscription and key for the Hotels.com provider
• Azure (optional): For related backend services
• Notion (optional): For documentation access

---