Quarkus MCP Agentic

🚀 Monolithic Application + MCP = Proxy Application

This project uses Quarkus (the Supersonic Subatomic Java Framework) and the Model Context Protocol to implement a simple proxy application, leveraging multiple MCP servers along with Quarkus + LangChain4j.

If you want to learn more about Quarkus, please visit its official website: https://quarkus.io/.

🚀 Quick Start

Prerequisites

• You need to install node and npm (used to start the MCP service). Install them into your system following the recommended method here.
• A container environment (e.g., Podman or Docker) is required if you want to view the built - in telemetry. Once the application is running, you can access the Grafana link through the Dev UI. If you don't have a container environment, comment out the telemetry - related parts in application.properties.
• Create a folder named playground in the project root directory (if you need to use the filesystem MCP server) or change the name in application.properties, but the folder must exist.
• Several MCP services require API keys. Here are the links to obtain the keys:
  • OpenAI - Get your API key.
  • Hugging Face - Get your Hugging Face API key.

Place this information in the src/main/resources/application.properties file as follows:

# OpenAI configuration
quarkus.langchain4j.mcp.openai.api-key=your-api-key
quarkus.langchain4j.mcp.openai.organization=your-organization-id

# Hugging Face configuration
quarkus.langchain4j.mcp.huggingface.api-key=your-hf-api-key

Running the Application in Development Mode

Follow the above steps to set up the environment and configure the keys, then you can start the application in development mode.

Testing the Application

Test the application interface with the following commands:

Basic Test

curl http://localhost:8080

Chat with LLM

curl -X POST http://localhost:8080/api/chat \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "Can you tell me how to learn programming?"}]}'

Packaging and Running the Application

Packaging the Application

./mvnw package

This will generate a quarkus-run.jar file in the target/quarkus-app/ directory. Note that this is not an uber - jar as the dependencies are copied to the target/quarkus-app/lib/ directory.

Running the Packaged Application

java -jar target/quarkus-app/quarkus-run.jar

Building an Uber - Jar

./mvnw package -Dquarkus.package.type=uber-jar

This allows you to run a single JAR file containing all dependencies.

Creating a Native Executable

Creating a Native Executable with GraalVM

./mvnw package -Dnative

Creating a Native Executable Using a Container

If GraalVM is not installed, you can use a container to build the native executable:

./mvnw package -Dnative -Dquarkus.native.container-build=true

Running the Native Executable

./target/research-1.0-SNAPSHOT-runner

If you want to learn more about building native executables, visit https://quarkus.io/guides/maven-tooling.

📚 Documentation

Related Guides

• LangChain4j Model Context Protocol Client: Guide
• LangChain4j OpenAI: Guide