使用说明

🌍 Travel Planner Agent

An AI-powered travel assistant that automates routing, cab booking, hotel reservations, and itinerary generation using MCP, Ola Maps, and Claude Sonnet.

🎯 Overview

Travel Planner Agent is an intelligent assistant that takes the hassle out of trip planning by:

Finding optimal routes between multiple destinations
Booking transportation (cabs) automatically
Reserving hotel accommodations
Creating detailed, time-optimized itineraries
Providing comprehensive travel recommendations

Perfect for travelers who want a seamless, all-in-one planning experience!

✨ Features

🗺️ Intelligent Route Planning

Geocoding for location discovery
Multi-stop route optimization
Real-time distance and duration calculations
Traffic-aware routing using Ola Maps API

🚕 Transportation Booking

Automated cab booking service integration
Pickup and dropoff scheduling
Driver assignment and tracking
Booking confirmation with reference IDs

🏨 Accommodation Management

Hotel availability checking
Automatic booking and confirmation
Location-based hotel recommendations

📅 Smart Itinerary Generation

Time-optimized schedules
Activity recommendations
Buffer time for meals and rest
Detailed attraction information

💡 Travel Intelligence

Must-visit location suggestions
Local cuisine recommendations
Budget estimates
Weather and timing considerations

🏗️ Architecture

┌─────────────────────────────────────────────┐
│         Travel Planner Agent (AI)           │
│              (Claude Sonnet)                │
└──────────────┬──────────────────────────────┘
               │
      ┌────────┴────────┐
      │                 │
      ▼                 ▼
┌──────────┐    ┌──────────────┐
│ Ola Maps │    │   Booking    │
│   MCP    │    │   Services   │
│ Server   │    │     MCP      │
└────┬─────┘    └──────┬───────┘
     │                 │
     ├─────────────────┼──────────────────┐
     │                 │                  │
     ▼                 ▼                  ▼
┌─────────┐    ┌──────────┐    ┌──────────────┐
│ Geocode │    │   Cab    │    │    Hotel     │
│   API   │    │ Booking  │    │   Booking    │
└─────────┘    │   API    │    │     API      │
┌─────────┐    └──────────┘    └──────────────┘
│ Routing │
│   API   │
└─────────┘
┌─────────┐
│  Route  │
│Optimizer│
└─────────┘

Technology Stack

AI Model: Claude Sonnet 4.5 (Anthropic)
Protocol: Model Context Protocol (MCP)
Maps API: Ola Maps Platform
Booking Services: Custom MCP-enabled booking APIs
Language: Python 3.8+

📦 Prerequisites

Before you begin, ensure you have:

Python 3.8 or higher
Claude API access (Anthropic)
Ola Maps API key
MCP server setup
Booking service credentials (if using real services)

🚀 Installation

1. Clone the Repository

git clone https://github.com/vj-vishal/travel-planner-agent.git
cd travel-planner-agent

2. Create Virtual Environment

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install Dependencies

pip install -r requirements.txt

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Anthropic - For Claude AI and MCP protocol
Ola Maps - For comprehensive mapping and routing APIs
Open Source Community - For various tools and libraries used in this project