MCP Server

🚀 Model Context Protocol (MCP) + Spring Boot Integration

This project integrates the Model Context Protocol (MCP) with Spring Boot, enabling seamless interaction between Spring Boot applications and AI agents.

🔗 Useful Links

• Introduction to MCP: modelcontextprotocol.io/introduction
• Spring AI MCP Documentation: docs.spring.io - MCP Client Boot Starter
• Goose (AI Agent) - Client Setup: block.github.io/goose

🚀 Quick Start

📦 Installation

Step 1: Create a JAR File

Build your Spring Boot application using the following command:

./gradlew clean build

The JAR file will be located in the target/ directory.

Step 2: Install and Configure Goose

Follow the official Goose documentation to install and configure the AI agent.

💻 Usage Examples

Running Your Spring Boot Application with Goose

You're now ready to run your Spring Boot application integrated with MCP and the Goose AI agent! 🧠🚀

Running Goose on WSL (Windows Subsystem for Linux)

If you're using WSL and encounter issues running a Goose session, follow these steps:

Step 1: Create a Shell Script

In your WSL terminal, create a file named run-extension.sh:

nano run-extension.sh

Paste the following content:

#!/bin/bash
java -jar "FULL_PATH_OF_JAR_FILE/target/mcp_feature-0.0.1-SNAPSHOT.jar"

Replace FULL_PATH_OF_JAR_FILE with the actual path to your JAR file.

Step 2: Ensure Java is Installed in WSL

If you encounter Java-related issues, make sure the JDK is installed:

java -version

If it's not installed, you can install OpenJDK using the following commands:

sudo apt update
sudo apt install openjdk-21-jdk

Step 3: Make the Script Executable

chmod +x run-extension.sh

Step 4: Start a Goose Session with Your Extension

goose session --with-extension="./run-extension.sh"