🌴 Travel Itinerary - FastAPI Project

by ThasnimaShereef

360 downloads Not rated yet

GitHub

Media

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.

Explore

- 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

---

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 Project

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "\ud83c\udf34 travel itinerary - fastapi project": {
            "Travel-Itinerary": {
                "command": "python",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

From the repository

``bash python -m venv venv

`bash pip install -r requirements.txt



- Go to https://render.com

- Create a New Web Service

- Connect your GitHub repo

- Set the Build Command to:

bash

  pip install -r requirements.txt



- Set the Start Command to:

bash

  uvicorn app.main:app --host 0.0.0.0 --port 10000



- Set Port to

10000`
- ✅ Deploy and wait for the live link!

---

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"
        ]
    }
}

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 venv

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

🚀 Live Demo

🧰 Tech Stack

📦 Features

📁 Folder Structure

⚙️ Features

🚀 Getting Started

📦 1. Clone the Repository

🧪 2. Create a Virtual Environment

More like this

Google Maps

BlenderMCP

AWS MCP Servers

Figma Context (Framelink)