galaxium-travels-mcp-compose-watsonx-orchestrate

thomassuedbroecker/galaxium-travels-mcp-compose-watsonx-orchestrate

3.1

If you are the rightful owner of galaxium-travels-mcp-compose-watsonx-orchestrate and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Model Context Protocol (MCP) server is a versatile tool designed to facilitate communication and integration between various applications and services, particularly in the context of AI and orchestration platforms.

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)

Related YouTube video

  1. How to Fix the MCP + watsonx Orchestrate Tutorial After ADK 2.x Changes Related YouTube video

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.

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