globetrotter-mcp-server

globetrotter-personal/globetrotter-mcp-server

3.1

If you are the rightful owner of globetrotter-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Globetrotter MCP Server is a Spring Boot-based server designed to facilitate interactions between AI assistants and the Globetrotter travel system.

Globetrotter MCP Server

A Spring Boot-based MCP (Model Context Protocol) server for the Globetrotter Travel Application.

Overview

This MCP server provides a standardized interface for AI assistants to interact with the Globetrotter travel system, enabling them to search for flights, manage bookings, and access travel-related information.

Features

  • RESTful API endpoints for MCP operations
  • Health monitoring and metrics
  • Configurable server settings
  • Spring Boot 3.2.5 with Java 17
  • Comprehensive logging and monitoring

Prerequisites

  • Java 17 or higher
  • Maven 3.6 or higher

Getting Started

Building the Project

mvn clean install

Running the Application

mvn spring-boot:run

The server will start on port 8082 by default.

Docker

# Build the Docker image
docker build -t globetrotter-mcp-server .

# Run the container
docker run -p 8082:8082 globetrotter-mcp-server

API Endpoints

Health Check

  • GET /api/mcp/health - Server health status

Server Information

  • GET /api/mcp/info - Server information and capabilities

Management Endpoints

  • GET /actuator/health - Spring Boot health check
  • GET /actuator/info - Application information
  • GET /actuator/metrics - Application metrics

Configuration

The application can be configured using the application.yml file or environment variables:

server:
  port: 8082

mcp:
  server:
    name: globetrotter-mcp-server
    version: 1.0.0
    description: MCP Server for Globetrotter Travel Application

Development

Project Structure

src/
ā”œā”€ā”€ main/
ā”‚   ā”œā”€ā”€ java/
ā”‚   ā”‚   ā””ā”€ā”€ com/globetrotter/mcp/
ā”‚   ā”‚       ā”œā”€ā”€ controller/
ā”‚   ā”‚       ā”œā”€ā”€ service/
ā”‚   ā”‚       ā”œā”€ā”€ model/
ā”‚   ā”‚       ā””ā”€ā”€ McpServerApplication.java
ā”‚   ā””ā”€ā”€ resources/
ā”‚       ā””ā”€ā”€ application.yml
ā””ā”€ā”€ test/
    ā””ā”€ā”€ java/
        ā””ā”€ā”€ com/globetrotter/mcp/

Adding New Endpoints

  1. Create a new controller in the controller package
  2. Add appropriate request/response models in the model package
  3. Implement business logic in the service package
  4. Add tests in the test directory

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Submit a pull request

License

This project is licensed under the MIT License.