Travel MCP Server

by gs-ysingh

Not rated
GitHub

About

A comprehensive travel planning server for flight search, accommodation booking, currency exchange, and weather forecasting.

Details

Author
gs-ysingh
Categories
Productivity, Other, Finance

Setup

Install Travel MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/gs-ysingh/travel-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

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

- πŸ›«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

git clone <repository-url> cd travel-mcp-server

- Set up environment variables:

- Copy.env.exampleto.env
- Fill in your API keys (seeAPI Keys Setup)

You'll need to obtain API keys from the following services:
- Flight API: Amadeus, Skyscanner, or similar flight data provider
- Accommodation API: Booking.com, Airbnb, or similar accommodation service
- Currency Exchange API: Fixer.io, ExchangeRate-API, or similar service
- Weather API: OpenWeatherMap, WeatherAPI, or similar weather service
- Google Places API: For attractions and restaurant recommendations

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

Run the server in development mode with hot reload:

Run with automatic restart on file changes:

The MCP server provides the following tools:

Search for flights between destinations with customizable options.

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

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

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

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

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

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

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

- 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
- Create a new service class insrc/services/
- Implement the required methods
- Register the service insrc/index.ts
- Add corresponding tools and handlers
- Fork the repository
- Create a feature branch:git checkout -b feature-name
- Make your changes
- Run tests:npm test
- Commit your changes:git commit -m 'Add feature'
- Push to the branch:git push origin feature-name
- Submit a pull request

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

If you encounter any issues or have questions:
- Check the
Issuessection
- Create a new issue with detailed information
- Provide logs and reproduction steps

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

-

AI2Fin | Intelligent Financial Management

Tools for expense tracking, tax deductions, bill management, and financial analysis.

Manage personal finances, track transactions, and create budgets with Budgetsco.

Provides real-time currency conversion and exchange rate data using the Frankfurter API.

Organizze Finance Manager MCP Server. Create transactions, consult balances, and manage goals.

Access and manage your Monarch Money financial data and operations.

Personal finance management with expense tracking, budget monitoring, and spending analysis

A suite of servers for intelligent travel planning, including flights, hotels, events, geocoding, weather, and finance.

An MCP server for YNAB (https://www.ynab.com/), exposing 20 tools for querying and managing your budget through any MCP-compatible client (Claude Desktop, etc.).

Log, query, and edit expenses, budgets, and accounts from Claude, ChatGPT, Cursor, or any MCP-compatible AI assistant β€” the only expense tracker with a native MCP server.

62 real-time data tools for AI agents via MCP. Finance, crypto, FMCSA, sanctions, courts, weather, vehicles, cybersecurity. One bearer token, one bill. Free tier available.

No reviews yet β€” be the first

Sign in to leave a review

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

Email sign in

No reviews posted yet.