End-to-End Agent Use Case Implementation with Galaxium Travels: Full Local Setup Guide and MCP

Galaxium Travels local MCP Server, watsonx Orchestrate Development Edition, and Docker-Compose

Table of Content

1. Blog post on IBM Developer
2. Disclamer
3. Related YouTube video
4. Repository content overview
5. The example application
6. Run the example

1. Blog post on IBM Developer

!!! IBM Developer Set up an end-to-end use case for local AI agents with MCP server and watsonx Orchestrate !!!

2. Disclamer

Custom Docker-Compose in watsonx Orchestrate is NOT official supported: https://developer.watson-orchestrate.ibm.com/developer_edition/custom_yaml

---

Important Note: Before starting watsonx Orchestrate Developer Edition with a custom Docker Compose file, make sure you understand every change in your configuration. The ADK doesn’t offers official support to custom Compose setups, so you’re responsible for troubleshooting any issues that arise.

3. Related YouTube videos

1. Galaxium + MCP + watsonx Orchestrate: Full Local Setup Guide (until watsonx Orchestrate version 1.x)

2. How to Fix the MCP + watsonx Orchestrate Tutorial After ADK 2.x Changes

4. Repository content overview

4.1 Basic Architecture

This repository demonstrates how to set up a MCP server locally and integrate it into the watsonx Orchestrate Development Edition using Docker-Compose.

• MCP Server: The image below shows simplified dependencies of the entire setup, including:

  • Docker Compose
  • watsonx Orchestrate Development Edition Server
    • Agent
    • Tools
    • Connection
  • Langfuse
  • MCP server

• watsonx Orchestrate ADK 1.x

• watsonx Orchestrate ADK 2.0 - 2.1

5. The example application

This repository contains resources for the "galaxium_travels_mcp-compose-watsonx-orchestrate" project, utilizing the watsonx Orchestrate Development Edition.

• Galaxium Travels Applications:

  • Galaxium Travels Booking MCP: http://localhost:8084/mcp
  • Galaxium Travels WebApp: http://localhost:8083
  • Galaxium Travels Booking: http://localhost:8082/docs
  • Galaxium Travels HR: http://localhost:8081/docs

• watsonx Orchestrate

  • Langfuse: http://localhost:3010
  • watsonx Orchestrate LiteChat: http://localhost:3000

• Related resources:

  • YouTube video: Galaxium + MCP + watsonx Orchestrate: Full Local Setup Guide to the following steps.

6. Run the example

Be aware that there are two versions to run the example with watsonx Orchestrate Development Edition in ADK: Version 1.x and 2.0/2.1.

follow the steps

• Version 1.x : 3 Set up the watsonx Orchestrate ADK and watsonx Orchestrate Development Server 5 Connect to MCP Gateway and MCP server
• Version 2.0-2.1 : 3.1 Set up the watsonx Orchestrate ADK and watsonx Orchestrate Development Server 5.1 Connect to MCP Gateway and MCP server

0. Clone this repository to your local machine

This is to ensure you use the same folder structure as defined in the following documentation.

git clone https://github.com/thomassuedbroecker/galaxium-travels-mcp-compose-watsonx-orchestrate.git
cd galaxium-travels-mcp-compose-watsonx-orchestrate

• Inspect the folder structure:

tree .
.
├── 1-galaxium_setup.md
├── 2-watsonx_adk_setup.md
├── 2-1-watsonx_adk_setup.md
├── 3-connect-to-the-mcp-server-with-mcp-inspector.md
├── 4-connect-to-the-mcp-server.md
├── 4-1-connect-to-the-mcp-server.md
├── 5-create-an-agent-and-test-the-mcp-tool.md
├── example-application-infrastructure
│   └── README.md
├── export_import
├── images
│   ├── connect-to-mcp-locally-01.jpg
│   ├── connect-to-mcp-locally-02.jpg
│   ├── connect-to-mcp-locally-03.jpg
│   ├── ...
│   └── mcp-server-overview-01.png
├── LICENSE
├── README.md
└── watsonx-orchestrate-adk
    └── README.md
    ├── setup_mcp_server_inside_watsonx_orchestrate_development_edition.sh
    ├── start_custom_compose_orchestrate_watsonx_orchestrate_development_edition.sh
    └── start_export_compose_orchestrate_watsonx_orchestrate_development_edition_sh

1. Start your container engine

Ensure your container engine is running on your desktop. Configuring container manager

Additional information:

• Docker Desktop (tested only on Mac OS):
  • Kubernetes must be enabled, Settings -> Kubernetes -> Enable Kubernetes, leave the rest by default (kubeadm is sufficient)
  • Start Docker Desktop neurally
  • Enter the .kube directory from your home directory under Settings -> Resources -> File sharing (i.e. /Users//.kube)

2. Set up the example Galaxium Travels Infrastructure

3. Set up the watsonx Orchestrate ADK and watsonx Orchestrate Development Server

3.1 (Version 2.0 -2.1) Set up the watsonx Orchestrate ADK and watsonx Orchestrate Development Server

4. Connect to the MCP server with MCP inspector

5. Connect to MCP Gateway and MCP server

5.1 (Version 2.0 -2.1) Connect to MCP Gateway and MCP server

6. Create a new Agent and test the MCP Tool

7. Additional resources

• The Galaxium Travels Examples

  • Galaxium Travels Infrastructure
  • Galaxium Travels Idea
  • Galaxium Travels Embedded Webchat Example
  • Galaxium Travels Evaluation Example
  • Galaxim Travels Knowledge Graph RAG example

• Blog posts

  • Integrating watsonx Orchestrate Agent Chat in Web Apps
  • Getting Started with Local AI Agents in the watsonx Orchestrate Development Edition
  • Building Agentic AI solutions with WatsonX Orchestrate and Remote MCP Servers: A Weather Tool Example
  • Converting SSE to STDIO via the MCP Gateway

• ADK documentation

  • Importing remote MCP toolkits
  • IBM watsonx Orchestrate Agent Development Kit

• MCP documentation

  • Transports