Modelcontextprotocolclient

🚀 ModelContextProtocolClient

A Spring Boot-based client application demonstrating different transport methods (WebFlux SSE, Stdio) for communication with the MCP server.

🚀 Quick Start

📦 Installation

Environment Configuration

1. Create a .env file in the project root directory and add the following content:

BRAVE_SEARCH_API_KEY=Your Brave Search API Key
WEATHER_API_KEY=Your Weather API Key

2. Clone the repository:

git clone https://github.com/InnoBridge/ModelContextProtocolServer

3. Docker Environment Configuration

   1. Update the volume mapping in docker-compose.yml:

    modelcontextprotocolclient_application
    ...
   volumes:
     - .:/app
     - /var/run/docker.sock:/var/run/docker.sock
     - ./local/root:/root
     - ../{Path to ModelContextProtocolServer}:/ModelContextProtocolServer
   

   2. Start the Docker container:

   sudo docker compose up
   

   3. Build and run the MCP server:

   # In a new terminal window
   sudo docker exec -it modelcontextprotocolserver-application sh
   cd /app
   ./mvnw clean install
   ./mvnw spring-boot:run
   

   4. Build and run the client:

   # In another new terminal window
   docker exec -it modelcontextprotocolclient-application sh
   ./mvnw spring-boot:run
   

💻 Usage Examples

Available Endpoints

WebFlux Transport

• GET /webflux/tools - List all available tools
• POST /webflux/calculate - Perform calculations using the calculator tool

  curl -X POST "http://localhost:8080/webflux/calculate?operation=add&a=5&b=3"
  

• POST /webflux/weather - Get weather information

  curl -X POST "http://localhost:8080/webflux/weather?location=San%20Francisco&format=celsius"
  

Stdio Transport

• GET /stdio/tools - List all available tools
• POST /stdio/calculate - Perform calculations using the calculator tool

  curl -X POST "http://localhost:8080/stdio/calculate?operation=add&a=5&b=3"
  

• POST /stdio/weather - Get weather information

  curl -X POST "http://localhost:8080/stdio/weather?location=San%20Francisco&format=celsius"
  

BraveSearch Transport

• GET /tools/bravesearch - List available tools
• POST /bravesearch - Perform a web search

  curl -X POST "http://localhost:8080/bravesearch?query=spring%20boot"
  

📚 Documentation

Configuration

The application supports multiple transport configurations:

1. WebFlux SSE Transport (Default)

   • Communicate with the server using Server-Sent Events.
   • The server must run in WebFlux mode.

2. Stdio Transport

   • Communicate with the server using standard input and output.
   • Automatically start the server JAR file and run it in stdio mode.

3. BraveSearch Transport

   • Communicate using the BraveSearch API.
   • Add BRAVE_SEARCH_API_KEY to the .env file.
   • Obtain the API key from Brave Search API.

4. Weather API

   • Used for weather information queries in WebFlux and Stdio transports.
   • Add WEATHER_API_KEY to the .env file.
   • Obtain the API key from WeatherAPI.