Wisnu MCP - Travel Booking Server 🌍

A Model Context Protocol (MCP) server for travel booking operations, built with FastMCP.

Features

This MCP server provides the following tools for travel booking:

Available Tools

1. search_flights - Search for available flights

   • Origin/destination airport codes

   • Departure and optional return dates

   • Passenger count and cabin class selection

2. search_hotels - Search for hotels in a location

   • Location-based search

   • Check-in/check-out dates

   • Guest count, room requirements, and rating filters

3. search_destinations - Get destination recommendations

   • Interest-based suggestions (beach, culture, adventure, food, etc.)

   • Budget range filtering

   • Seasonal preferences

4. calculate_trip_cost - Estimate total trip costs

   • Flight and hotel cost inputs

   • Daily expense calculations

   • Per-person cost breakdown

5. get_travel_tips - Get travel tips for destinations

   • Destination-specific advice

   • Trip type considerations (business, leisure, adventure, family)

Installation

This project uses uv for dependency management.

Prerequisites

• Python 3.13+

• uv package manager

Setup

1. Clone or navigate to this repository:

2. The virtual environment and dependencies are already set up. If you need to reinstall:

Usage

Running the Server

Start the MCP server with:

Or if you want to run it directly with Python:

Connecting to Claude Desktop

To use this MCP server with Claude Desktop, add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

After updating the configuration, restart Claude Desktop.

Testing the Server

You can test individual tools by modifying main.py to call them directly:

Development

Project Structure

Adding New Tools

To add a new tool to the MCP server:

1. Define a new function in main.py

2. Decorate it with @mcp.tool()

3. Add comprehensive docstrings (they become tool descriptions)

4. Use type hints for all parameters

Example:

Adding Dependencies

To add new Python packages:

For example, to add a real flight API client:

Next Steps

The current implementation provides mock responses. To build a production-ready travel booking system:

1. Integrate Real APIs: Connect to actual flight, hotel, and destination APIs

   • Amadeus API for flights and hotels

   • Skyscanner API for comprehensive travel search

   • Booking.com API for accommodations

2. Add Resources: Use FastMCP's @mcp.resource() decorator to expose travel data

3. Add Prompts: Create @mcp.prompt() templates for common travel queries

4. Error Handling: Implement robust error handling for API failures

5. Caching: Add caching for frequently searched routes/destinations

6. Authentication: Add API key management for external services

7. Testing: Add unit and integration tests

Resources

• FastMCP Documentation

• Model Context Protocol Specification

• uv Documentation

License

MIT