hotels-mcp/
├── pyproject.toml        # PEP 517/518 build config, dependencies & CLI entrypoints
├── README.md             # Documentation & usage guide
├── AGENTS.md             # Agent guidelines & GitNexus code intelligence
├── CLAUDE.md             # Claude developer instructions
├── tests/
│   ├── __init__.py
│   └── test_server.py    # 17 live multi-provider integration test suites
└── src/
    └── travel_mcp/
        ├── __init__.py   # Package root
        ├── __main__.py   # CLI entrypoint (`python -m travel_mcp`)
        ├── server.py     # FastMCP server instance, tools, prompts & resources
        ├── models.py     # Normalized Pydantic DTOs for travel, dining, and transit
        └── providers/
            ├── __init__.py         # Unified provider factory & registry
            ├── accommodations/     # Hotel accommodation providers
            │   ├── __init__.py
            │   ├── base.py         # HotelProvider ABC & session loader
            │   ├── agoda.py        # Agoda accommodation provider
            │   ├── booking.py      # Booking.com accommodation provider
            │   └── hotels_com.py   # Hotels.com accommodation provider
            ├── dining/             # Restaurant & cafe providers
            │   ├── __init__.py     # Dining provider factory
            │   ├── base.py         # DiningProvider ABC
            │   └── tabelog.py      # Tabelog client & vacancy parser
            ├── routes/             # Multi-modal routing providers
            │   ├── __init__.py     # Route provider factory
            │   ├── base.py         # RouteProvider ABC
            │   └── kakao.py        # Kakao Maps routing provider
            └── reviews/            # Unified place review providers
                ├── __init__.py     # Review provider registry
                ├── base.py         # ReviewProvider ABC
                ├── agoda.py        # Agoda reviews provider
                ├── google.py       # Google Reviews provider
                ├── kakao.py        # Kakao Place reviews provider
                └── tabelog.py      # Tabelog reviews provider

cd /Users/richardluo/Developer/hotels-mcp
uv sync

uv run python tests/test_server.py

uv run travel-mcp
# or
uv run python -m travel_mcp

{
  "mcpServers": {
    "travel_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/richardluo/Developer/hotels-mcp",
        "run",
        "python",
        "-m",
        "travel_mcp"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}