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 https://github.com/josondev/neuronworks-travel-agent
cd travel-mcp-server

1. Install dependencies:

npm install

1. 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