Travel Itinerary Management System
LocalAbout Travel Itinerary Management System
Travel Itinerary Management System is a full-stack itinerary manager for Thailand destinations, with a FastAPI backend and Next.js frontend. It supports viewing and creating itineraries, plus recommendations for Phuket and Krabi based on trip duration.
Key features
- 01Browse itineraries and their details
- 02Create custom travel itineraries
- 03Get recommendations by trip duration
- 04Manage accommodation, transfers, and activities
Use cases
- 01Review existing itineraries for Thailand
- 02Find Phuket or Krabi plans for a trip duration
- 03Create a trip plan with stays and activities
MCP support
The project includes an MCP recommendation server that suggests Phuket and Krabi itineraries based on trip duration.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMETravel Itinerary Management System
A full-stack application for managing travel itineraries for Thailand destinations, featuring a FastAPI backend and Next.js frontend.
Project Structure
``` travel-itinerary-system/ ├── backend/ # Python FastAPI backend ├── frontend/ # Next.js frontend └── README.md # Project documentation ```
Backend Setup
The backend is built with FastAPI, SQLAlchemy, and SQLite.
Prerequisites
- Python 3.8+
- pip
Installation
-
Navigate to the backend directory: ```bash cd backend ```
-
Create a virtual environment: ```bash python -m venv venv ```
-
Activate the virtual environment:
- Windows:
venv\Scripts\activate - macOS/Linux:
source venv/bin/activate
- Windows:
-
Install dependencies: ```bash pip install fastapi uvicorn sqlalchemy pydantic ```
Running the Backend
- Run the application using the run script: ```bash python run.py ```
This will:
- Seed the database with sample data
- Start the main API server on http://localhost:8000
- Start the recommendation server on http://localhost:8001
The API documentation will be available at http://localhost:8000/docs
Frontend Setup
The frontend is built with Next.js, React, and Tailwind CSS.
Prerequisites
- Node.js 16+
- npm or yarn
Installation
-
Navigate to the frontend directory: ```bash cd frontend ```
-
Install dependencies: ```bash npm install
or
yarn install ```
Running the Frontend
-
Start the development server: ```bash npm run dev
or
yarn dev ```
-
Open your browser and navigate to http://localhost:3000
Using the Application
- Browse Itineraries: View all available travel itineraries on the Itineraries page
- View Details: Click on an itinerary to see its detailed information
- Get Recommendations: Use the Recommendations page to get itineraries based on your preferred duration
- Create Itinerary: Create your own custom itinerary using the multi-step form
API Endpoints
GET /api/itineraries- Get all itinerariesGET /api/itineraries/{id}- Get a specific itineraryPOST /api/itineraries- Create a new itineraryGET /api/recommendations/{nights}- Get recommended itineraries for a specific duration
Database Schema
The application uses the following database models:
- Itinerary
- Accommodation
- Transfer
- Activity
See the Schema page in the frontend for detailed information.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.