🌴 Travel Itinerary - FastAPI Project
About
This is a backend system for managing travel itineraries using FastAPI and SQLAlchemy, featuring RESTful APIs to create and view itineraries and an MCP server to recommend itineraries based on trip duration.
Details
- Author
- ThasnimaShereef
- Downloads
- 360
- Categories
- Media
Jump to
- Create travel itineraries with hotels, transfers, and excursions
- View all stored itineraries or retrieve by ID
- Recommend itineraries for 2 to 8-night durations (MCP)
- Pre-seeded data for Phuket and Krabi, Thailand
- Auto-generated Swagger UI and ReDoc documentation
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
🌴 Travel Itinerary - FastAPI ProjectCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, create a virtual environment, install dependencies with pip install -r requirements.txt, and run the development server with uvicorn app.main:app --reload. API endpoints are accessible via the interactive Swagger UI at http://127.0.0.1:8000/docs. A live demo is available at the Render deployment URL.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\ud83c\udf34 travel itinerary - fastapi project": {
"Travel-Itinerary": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}
}
}McpServers
{
"Travel-Itinerary": {
"command": "python",
"args": [
"-m",
"venv",
"venv"
]
}
}🌴 Travel Itinerary - FastAPI Project
This is a backend system for managing travel itineraries using FastAPI and SQLAlchemy, featuring RESTful APIs to create and view itineraries and an MCP server to recommend itineraries based on trip duration. ---🚀 Live Demo
🌐 Live URL: https://travel-itinerary-fdwd.onrender.com/docs ---🧰 Tech Stack
- Python 3.11+ - FastAPI - SQLAlchemy - SQLite (for development; switchable to PostgreSQL) - Uvicorn - Render (for deployment) - Pydantic (for input validation) ---📦 Features
- Create new itineraries with full day-wise breakdown - View all stored itineraries - MCP (Minimum Cost Path) server for recommending itineraries based on nights - Pre-seeded data for Phuket and Krabi, Thailand - Interactive Swagger UI for testing endpoints ---📁 Folder Structure
``
travel-itinerary-backend/
│
├── app/ # Main application package
│ ├── __init__.py # Makes the app a Python package
│ ├── main.py # Entry point of FastAPI app
│ ├── models.py # SQLAlchemy models
│ ├── database.py # DB connection setup
│ ├── schemas.py # Pydantic schemas for validation
│ ├── seed_data.py # Predefined itinerary data
│ └── routes/ # API route definitions
│ ├── itineraries.py # CRUD routes for itineraries
│
├── requirements.txt # Project dependencies
├── README.md # Project documentation
├── .gitignore # Files to ignore in Git
└── start.sh # (Optional) Start script for deployment
`
---
⚙️ Features
- ✅ Create travel itineraries with hotel, transfer, and excursion data
- ✅ Get recommended itineraries for 2 to 8-night durations
- ✅ Modular code with FastAPI, SQLAlchemy, and SQLite
- ✅ Auto-generated Swagger and ReDoc API docs
- ✅ Deployed live using Render
---
🚀 Getting Started
📦 1. Clone the Repository
`bash
git clone https://github.com/ThasnimaShereef/Travel-Itinerary.git
cd Travel-Itinerary
`
🧪 2. Create a Virtual Environment
``bash
python -m venv venvSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
