Travel

Travel MCP Server is a versatile MCP-based backend that enables comprehensive travel planning. It exposes tools for flight and accommodation search, currency exchange, weather forecasts, and trip budgeting, allowing clients to orchestrate end-to-end travel planning in a consistent, context-aware way.

How to use

You can connect this MCP server to any MCP-compatible client to perform travel-related tasks. Use it to search flights and accommodations, fetch real-time exchange rates, check weather forecasts for destinations, and estimate trip budgets. Each action is exposed as a dedicated tool that you call through your MCP client, receiving structured results you can present to users.

Key capabilities you can leverage with your MCP client include the following tools: flight search, accommodation search, exchange rate lookups, weather forecasts, and trip budget calculations. Use the client to pass the required parameters for each tool and consume the returned results for display or further processing.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine. Preferably use a Node.js version supported by the project (commonly LTS). Verify with node -v and npm -v.

Step 1: Clone the repository and navigate into the project directory.

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

Step 2: Install dependencies.

npm install

Step 3: Configure environment variables. Copy the example environment file and fill in your API keys for all required services.

cp .env.example .env

Edit .env to provide keys for flight, accommodation, currency, weather, and Google Places APIs as needed.

Step 4: Run in development mode with hot reload during active development.

npm run dev

Step 5: For production, build the server and start it.

npm run build npm start

Step 6: If you want file-watching with automatic restarts during development, use watch mode.

npm run watch

## MCP client configuration and environment notes

This server is designed to be used with MCP-compatible clients. To add it to an MCP client, use the following configuration. It runs the server locally via an MCP runtime, so your client can invoke the Travel MCP Server tools as if calling remote endpoints.

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

## Additional notes

Environment variables used by the server should be kept secure and never committed to version control. Use a dedicated runtime environment or secret management for keys. If you need to customize tool behavior or add new services, you can extend the codebase in a structured way by adding new service classes and registering them in the main server entry point.

## Available tools

### search\_flights

Search for flights between origin and destination with date, passenger, and class options.

### search\_accommodation

Search for hotels, vacation rentals, and other accommodations with destination, dates, guests, and room details.

### get\_exchange\_rate

Retrieve current exchange rates between two currencies and optionally convert a specified amount.

### get\_weather\_forecast

Fetch weather conditions for a location and date, with optional forecast horizon.

### calculate\_trip\_budget

Estimate trip costs by combining flights, accommodation, and daily expenses based on duration and travelers.