Pular para o conteúdo principal

Quarkus Langchain4J support to MCP Servers is AMAZING

 We talked about Tools and then MCP. In this post let's talk how to use Quarkus and lanchaing4j to connect your intelligent application to MCP servers!

Requirements


  • Java Open JDK  (24 is preferred)
  • Maven
  • Ollama with at least one LLM model that you can locally. Notice that you could use other providers such as ramalama and vllm, but you will need to use the correct dependencies for OpenAI API.
  • jbang, npx or other tool required top run the MCP server


The LLM client application


Our application simple needs the dependencies quarkus-langchain4j-mcp, quarkus-langchain4j-ollama and quarkus-rest. You can generate your application online using Code Quarkus. About the code, you only need one single interface:

import dev.langchain4j.service.SystemMessage;
import io.quarkiverse.langchain4j.RegisterAiService;

@RegisterAiService
public interface AIService {

@SystemMessage("You are a nice and helpful assistant.")
String input(String input);

}


Once this code is added, The next step is to configure the application. Open the file application.properties and configure at least the ollama model that you will use. Other configuration are also possible as described in Quarkus langchain4j documentation.

quarkus.langchain4j.ollama.chat-model.model-id=qwen2.5:latest


That's all to have a working  assistant! You can run the app using your IDE (for example, using Quarkus VS Code extension) or go to a terminal, navigate to the project root and run mvn clean compile quarkus:dev


Once the server is started, you can navigate to DEVUI, select the langchain4j card and chat with your LLM:


Quarkus DEV UI


Chat with our assistant


From now you could inject your service and integrate with other stuff, but lets stick with the dev UI for now.


Registering MCP Server


A MCP Server can bring many functionalities to your LLM and there are thousand MCP Servers ready for use! In our example let's use the JDBC MCP Server. What you need to do is simply configure this provider. See how it looks like in our application.properties :


quarkus.langchain4j.mcp.jdbc.transport-type=stdio
quarkus.langchain4j.mcp.jdbc.command=jbang,jdbc@quarkiverse/quarkus-mcp-servers


In this configuration we simply declare the transport type (how our MCP client will comunicate with the MCP Server) and the parameters to start the MCP server! We can also use a JDBC connection URL, if you don't provide it, then the MCP Server will use an in memory H2 database. For example, if we want to use sqlite you simply have to use the following configuration:


jbang,jdbc@quarkiverse/quarkus-mcp-servers,jdbc:sqlite:./database.db


Now if you restart your application and go back to the DEV UI you will see that your client can handle a SQL Database in plain English!


Asking the LLM to create a table in plain English
We can see that our table was created!
It can even describe our table
You can quickly insert mock data as well
On SQL Viewer App you can upload the generated sqlite database and see if the data is correct!




MCP advantages

There's a good discussion about what MCP brings to the table. If you are on future, probably you know if MCP is a standard for plugging Tools into LLM or not. In our example the advantage is clear: we gave superpowers to our application by simply modifying a configuration!

My wish list for Quarkus Langchain4j MCP extension is only a good web UI that shows the registered MCP Servers and possibly even allow us to interact with it!


Conclusion

MCP and LLMs, Agents and event the new A2A protocol are another world, but it is still programming , exciting times we live on! I was very surprise how easy it was to create this post and test MCP Servers using Quarkus, the most powerful Java framework.


See the code on my Github












Marcadores

Marcadores:

Comentários

Postar um comentário

Postagens mais visitadas deste blog

Dancing lights with Arduino - The idea

I have been having fun with Arduino these days! In this article I am going to show how did I use an electret mic with Arduino to create a Dancing Lights circuit. Dancing Lights   I used to be an eletronician before starting the IT college. I had my own electronics maintenance office to fix television, radios, etc. In my free time I used to create electronic projects to sell and I made a few "reais" selling a version of Dancing lights, but it was too limited: it simply animated lamps using a relay in the output of a 4017 CMOS IC. The circuit was a decimal counter  controlled by a 555. 4017 decimal counter. Source in the image When I met Arduino a few years ago, I was skeptical because I said: I can do this with IC, why should I use a microcontroller. I thought that Arduino was for kids. But now my pride is gone and I am having a lot of fun with Arduino :-) The implementation of Dancing Lights with Arduino uses an electret mic to capture the sound and light leds...
Postar um comentário
Leia mais

Genetic algorithms with Java

One of the most fascinating topics in computer science world is Artificial Intelligence . A subset of Artificial intelligence are the algorithms that were created inspired in the nature. In this group, we have Genetic Algorithms  (GA). Genetic Algorithms  To find out more about this topic I recommend the following MIT lecture and the Nature of Code book and videos created by Daniel Shiffman. Genetic Algorithms using Java After I remembered the basics about it, I wanted to practice, so I tried my own implementation, but I would have to write a lot of code to do what certainly others already did. So I started looking for Genetic Algorithm libraries and found Jenetics , which is a modern library that uses Java 8 concepts and APIs, and there's also JGAP . I decided to use Jenetics because the User Guide was so clear and it has no other dependency, but Java 8. The only thing I missed for Jenetics are more small examples like the ones I will show i...
Postar um comentário
Leia mais

Simplest JavaFX ComboBox autocomplete

Based on this Brazilian community post , I've created a sample Combobox auto complete. What it basically does is: When user type with the combobox selected, it will work on a temporary string to store the typed text; Each key typed leads to the combobox to be showed and updated If backspace is type, we update the filter Each key typed shows the combo box items, when the combobox is hidden, the filter is cleaned and the tooltip is hidden:   The class code and a sample application is below. I also added the source to my personal github , sent me PR to improve it and there are a lot of things to improve, like space and accents support.
2 comentários
Leia mais