Travel MCP Server

A Model Context Protocol (MCP) server for comprehensive travel planning, providing flight search, accommodation booking, currency exchange, weather forecasting, and trip budget calculation capabilities.

Features

• 🛫 Flight Search: Find and compare flights with various options
• 🏨 Accommodation Search: Search for hotels, vacation rentals, and other accommodations
• 💱 Currency Exchange: Get real-time exchange rates for travel budgeting
• 🌤️ Weather Forecast: Check weather conditions for your travel dates
• 💰 Trip Budget Calculator: Calculate and plan your travel expenses

Installation

1. Clone the repository:

git clone 
cd travel-mcp-server

2. Install dependencies:

npm install

3. Set up environment variables:

API Keys Setup

You'll need to obtain API keys from the following services:

1. Flight API: Amadeus, Skyscanner, or similar flight data provider

2. Accommodation API: Booking.com, Airbnb, or similar accommodation service

3. Currency Exchange API: Fixer.io, ExchangeRate-API, or similar service

4. Weather API: OpenWeatherMap, WeatherAPI, or similar weather service

5. Google Places API: For attractions and restaurant recommendations

Update your `.env` file with these keys:

FLIGHT_API_KEY=your_flight_api_key
BOOKING_API_KEY=your_booking_api_key
EXCHANGE_API_KEY=your_exchange_api_key
WEATHER_API_KEY=your_weather_api_key
GOOGLE_PLACES_API_KEY=your_google_places_api_key

Usage

Development

Run the server in development mode with hot reload:

npm run dev

Production

Build and start the server:

npm run build
npm start

Watch Mode

Run with automatic restart on file changes:

npm run watch

Available Tools

The MCP server provides the following tools:

1. Search Flights (`search_flights`)

Search for flights between destinations with customizable options.

Parameters:

• `origin`: Departure airport/city
• `destination`: Arrival airport/city
• `departureDate`: Departure date
• `returnDate`: Return date (optional for one-way)
• `passengers`: Number of passengers
• `class`: Flight class (economy, business, first)

2. Search Accommodation (`search_accommodation`)

Find hotels, vacation rentals, and other accommodation options.

Parameters:

• `destination`: City or location
• `checkIn`: Check-in date
• `checkOut`: Check-out date
• `guests`: Number of guests
• `rooms`: Number of rooms
• `type`: Accommodation type (hotel, apartment, etc.)

3. Get Exchange Rate (`get_exchange_rate`)

Get current exchange rates between currencies.

Parameters:

• `from`: Source currency code (e.g., USD)
• `to`: Target currency code (e.g., EUR)
• `amount`: Amount to convert (optional)

4. Get Weather Forecast (`get_weather_forecast`)

Check weather conditions for your travel destination.

Parameters:

• `location`: City or location
• `date`: Date for forecast
• `days`: Number of days to forecast (optional)

5. Calculate Trip Budget (`calculate_trip_budget`)

Calculate estimated trip costs including flights, accommodation, and daily expenses.

Parameters:

• `destination`: Travel destination
• `duration`: Trip duration in days
• `travelers`: Number of travelers
• `category`: Budget category (budget, mid-range, luxury)

Project Structure

travel-mcp-server/
├── src/
│   ├── index.ts              # Main server entry point
│   └── services/
│       ├── FlightService.ts       # Flight search functionality
│       ├── AccommodationService.ts # Accommodation search
│       ├── CurrencyService.ts     # Currency exchange
│       └── WeatherService.ts      # Weather forecasting
├── dist/                     # Compiled TypeScript output
├── package.json             # Project dependencies and scripts
├── tsconfig.json           # TypeScript configuration
├── .env                    # Environment variables (not in repo)
├── .gitignore             # Git ignore rules
└── README.md              # This file

Integration with MCP Clients

This server can be used with any MCP-compatible client such as:

• Claude Desktop
• Other AI assistants supporting MCP
• Custom MCP client applications

Add the server to your MCP client configuration:

{
  "mcpServers": {
    "travel-planner": {
      "command": "npx",
      "args": ["travel-mcp-server"]
    }
  }
}

Development Guide

Tech Stack

• TypeScript: Type-safe JavaScript development
• Node.js: Runtime environment
• MCP SDK: Model Context Protocol implementation
• Axios: HTTP client for API requests
• Zod: Schema validation
• dotenv: Environment variable management

Adding New Services

1. Create a new service class in `src/services/`

2. Implement the required methods

3. Register the service in `src/index.ts`

4. Add corresponding tools and handlers

Running Tests

npm test

Contributing

1. Fork the repository

2. Create a feature branch: `git checkout -b feature-name`

3. Make your changes

4. Run tests: `npm test`

5. Commit your changes: `git commit -m 'Add feature'`

6. Push to the branch: `git push origin feature-name`

7. Submit a pull request

License

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

Support

If you encounter any issues or have questions:

1. Check the Issues section

2. Create a new issue with detailed information

3. Provide logs and reproduction steps

Roadmap

• [ ] Add more travel service integrations
• [ ] Implement caching for API responses
• [ ] Add travel itinerary planning
• [ ] Support for group travel coordination
• [ ] Integration with calendar services
• [ ] Mobile app companion

Note: Remember to keep your API keys secure and never commit them to version control. Always use environment variables for sensitive configuration.