🌴 Travel Itinerary - FastAPI Project

Name: 🌴 Travel Itinerary - FastAPI Project
Author: ThasnimaShereef

@ThasnimaShereef

About 🌴 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.

#travel #itinerary #fastapi

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Travel-Itinerary": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 🌴 Travel Itinerary - FastAPI Project?

This is a backend system for managing travel itineraries built with FastAPI and SQLAlchemy. It provides RESTful APIs to create and view itineraries, and includes a Minimum Cost Path (MCP) server that recommends itineraries based on trip duration. It is designed for developers and travelers who need a programmatic way to store, retrieve, and recommend travel plans, with pre-seeded data for Phuket and Krabi, Thailand.

How to use 🌴 Travel Itinerary - FastAPI Project?

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.

Key features of 🌴 Travel Itinerary - FastAPI Project

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

Use cases of 🌴 Travel Itinerary - FastAPI Project

Build a travel planning tool that stores custom day-wise itineraries
Integrate itinerary recommendations into a trip-booking application
Test and prototype itinerary management with a live API and sample data
Deploy a lightweight, modular backend for a travel dashboard or mobile app

FAQ from 🌴 Travel Itinerary - FastAPI Project

What does "MCP" mean in this project?

MCP stands for Minimum Cost Path, a server endpoint that recommends itineraries based on the number of nights (duration) provided. It is not related to the Model Context Protocol.

What are the runtime requirements?

Python 3.11+ and the dependencies listed in requirements.txt (FastAPI, SQLAlchemy, Uvicorn, etc.). SQLite is used for development; PostgreSQL can be substituted.

How can I test the API?

After running the server, visit the interactive Swagger UI at /docs or the live demo at https://travel-itinerary-fdwd.onrender.com/docs. Available endpoints include POST /itineraries/, GET /itineraries/, GET /itineraries/{id}, and GET /recommendations/{duration}.

Where does the data live?

By default, the application uses an SQLite database file for development. The README notes that it is switchable to PostgreSQL for production.

Does the project include sample data?

Yes. The system comes with pre-seeded itineraries for Phuket and Krabi, Thailand, accessible immediately after running the server.

Comments

More Media & Design MCP servers

Weather API MCP Server

TuanKiri

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Claude to retrieve and interpret real-time weather data. Discuss on Hacker News:

247