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

Related MCP server: Concierge Voyage MCP

Installation

1. Clone the repository:

git clone https://github.com/josondev/neuronworks-travel-agent
cd travel-mcp-server

2. Install dependencies:

npm install

3. Set up environment variables:

   • Copy .env.example to .env

   • Fill in your API keys (see API Keys Setup)

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. GeoAppify 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
GEOAPIFY_API_KEY=your_geoappify_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