Quarkus MCP Server

Quarkus MCP Server

<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->

<!-- ALL-CONTRIBUTORS-BADGE:END -->

This Quarkus extension provides both declarative and programmatic APIs that enable developers to easily implement MCP¹ server features.

[!NOTE]
The LangChain4j project provides the MCP client functionality, either as a low-level programmatic API or as a full-fledged integration into AI-infused applications.

Get Started

Step #1

Add the following dependency to your POM file:

<dependency>
    <groupId>io.quarkiverse.mcp</groupId>
    <artifactId>quarkus-mcp-server-http</artifactId>
    <version>${quarkus-mcp-server-version}</version>
</dependency>

[!NOTE]
This dependency includes both the legacy "HTTP/SSE" and the "Streamable HTTP" transport. Use the quarkus-mcp-server-stdio artifactId if you want to use the STDIO transport instead. See also the Transports section in the docs for more information.

Step #2

Add server features (prompts, resources and tools) represented by annotated business methods of CDI beans.

import jakarta.inject.Inject;

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

import io.quarkiverse.mcp.server.BlobResourceContents;
import io.quarkiverse.mcp.server.Prompt;
import io.quarkiverse.mcp.server.PromptArg;
import io.quarkiverse.mcp.server.PromptMessage;
import io.quarkiverse.mcp.server.Resource;
import io.quarkiverse.mcp.server.TextContent;
import io.quarkiverse.mcp.server.Tool;

// This class is automatically registered as a @Singleton CDI bean
public class MyFeatures {

    @Inject
    CodeService codeService;

    @Tool(description = "Converts the string value to lower case")
    String toLowerCase(String value) {
        return value.toLowerCase();
    }

    @Prompt(name = "code_assist")
    PromptMessage codeAssist(@PromptArg(name = "lang") String language) {
        return PromptMessage.withUserRole(new TextContent(codeService.assist(language)));
    }

    @Resource(uri = "file:///project/alpha.txt")
    byte[] alpha() throws IOException{
        return Files.readAllBytes(Path.of("alpha.txt"));
    }

}

Step #3

Run your Quarkus app and have fun!

Documentation

The full documentation is available at https://quarkiverse.github.io/quarkiverse-docs/quarkus-mcp-server/dev/index.html.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/mkouba"><img src="https://avatars.githubusercontent.com/u/913004?v=4&size=100" width="100px" height="100px" alt="Martin Kouba"/><br />_{<b>Martin Kouba</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=mkouba" title="Code">💻</a> <a href="#maintenance-mkouba" title="Maintenance">🚧</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/geoand"><img src="https://avatars.githubusercontent.com/u/4374975?v=4&size=100" width="100px" height="100px" alt="Georgios Andrianakis"/><br />_{<b>Georgios Andrianakis</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=geoand" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://xam.dk"><img src="https://avatars.githubusercontent.com/u/54129?v=4&size=100" width="100px" height="100px" alt="Max Rydahl Andersen"/><br />_{<b>Max Rydahl Andersen</b>}</a><br /><a href="#example-maxandersen" title="Examples">💡</a></td> <td align="center" valign="top" width="14.28%"><a href="https://twitter.com/r_svoboda"><img src="https://avatars.githubusercontent.com/u/925259?v=4&size=100" width="100px" height="100px" alt="Rostislav Svoboda"/><br />_{<b>Rostislav Svoboda</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=rsvoboda" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/gastaldi"><img src="https://avatars.githubusercontent.com/u/54133?v=4&size=100" width="100px" height="100px" alt="George Gastaldi"/><br />_{<b>George Gastaldi</b>}</a><br /><a href="#infra-gastaldi" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/jmartisk"><img src="https://avatars.githubusercontent.com/u/937315?v=4&size=100" width="100px" height="100px" alt="Jan Martiska"/><br />_{<b>Jan Martiska</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=jmartisk" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="http://iocanel.com"><img src="https://avatars.githubusercontent.com/u/402008?v=4&size=100" width="100px" height="100px" alt="Ioannis Canellos"/><br />_{<b>Ioannis Canellos</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=iocanel" title="Code">💻</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/sberyozkin"><img src="https://avatars.githubusercontent.com/u/467639?v=4&size=100" width="100px" height="100px" alt="Sergey Beryozkin"/><br />_{<b>Sergey Beryozkin</b>}</a><br /><a href="#example-sberyozkin" title="Examples">💡</a></td> <td align="center" valign="top" width="14.28%"><a href="http://kpavlov.me"><img src="https://avatars.githubusercontent.com/u/1517853?v=4&size=100" width="100px" height="100px" alt="Konstantin Pavlov"/><br />_{<b>Konstantin Pavlov</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=kpavlov" title="Tests">⚠️</a> <a href="#infra-kpavlov" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/mvduijnhoven"><img src="https://avatars.githubusercontent.com/u/16058040?v=4&size=100" width="100px" height="100px" alt="Martijn van Duijnhoven"/><br />_{<b>Martijn van Duijnhoven</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=mvduijnhoven" title="Code">💻</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=mvduijnhoven" title="Tests">⚠️</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=mvduijnhoven" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/PierreBtz"><img src="https://avatars.githubusercontent.com/u/9881659?v=4&size=100" width="100px" height="100px" alt="Pierre Beitz"/><br />_{<b>Pierre Beitz</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=PierreBtz" title="Code">💻</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=PierreBtz" title="Tests">⚠️</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/mrecouly"><img src="https://avatars.githubusercontent.com/u/583648?v=4&size=100" width="100px" height="100px" alt="Matthieu Recouly"/><br />_{<b>Matthieu Recouly</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=mrecouly" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://wjglerum.nl"><img src="https://avatars.githubusercontent.com/u/7404187?v=4&size=100" width="100px" height="100px" alt="Willem Jan Glerum"/><br />_{<b>Willem Jan Glerum</b>}</a><br /><a href="#infra-wjglerum" title="Infrastructure (Hosting, Build-Tools, etc)">🚇</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/SaSteffen"><img src="https://avatars.githubusercontent.com/u/93011641?v=4&size=100" width="100px" height="100px" alt="Sascha Steffen"/><br />_{<b>Sascha Steffen</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=SaSteffen" title="Code">💻</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=SaSteffen" title="Tests">⚠️</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/cescoffier"><img src="https://avatars.githubusercontent.com/u/402301?v=4&size=100" width="100px" height="100px" alt="Clement Escoffier"/><br />_{<b>Clement Escoffier</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=cescoffier" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/rolfedh"><img src="https://avatars.githubusercontent.com/u/350907?v=4&size=100" width="100px" height="100px" alt="Rolfe Dlugy-Hegwer"/><br />_{<b>Rolfe Dlugy-Hegwer</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=rolfedh" title="Documentation">📖</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=rolfedh" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="http://brunobat.com/about"><img src="https://avatars.githubusercontent.com/u/2318030?v=4&size=100" width="100px" height="100px" alt="Bruno Baptista"/><br />_{<b>Bruno Baptista</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=brunobat" title="Documentation">📖</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=brunobat" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/moayad-alyaghshi"><img src="https://avatars.githubusercontent.com/u/49444460?v=4&size=100" width="100px" height="100px" alt="Moayad Alyaghshi"/><br />_{<b>Moayad Alyaghshi</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/issues?q=author%3Amoayad-alyaghshi" title="Bug reports">🐛</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=moayad-alyaghshi" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="http://www.dkornel.com"><img src="https://avatars.githubusercontent.com/u/11318335?v=4&size=100" width="100px" height="100px" alt="David Kornel"/><br />_{<b>David Kornel</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/issues?q=author%3Akornys" title="Bug reports">🐛</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=kornys" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/ian-stewart-71872851/"><img src="https://avatars.githubusercontent.com/u/990120?v=4&size=100" width="100px" height="100px" alt="Ian Stewart"/><br />_{<b>Ian Stewart</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/issues?q=author%3Aikstewa" title="Bug reports">🐛</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=ikstewa" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://erichare.me"><img src="https://avatars.githubusercontent.com/u/700235?v=4&size=100" width="100px" height="100px" alt="Eric Hare"/><br />_{<b>Eric Hare</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/issues?q=author%3Aerichare" title="Bug reports">🐛</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=erichare" title="Code">💻</a></td> </tr> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/mumuzi6"><img src="https://avatars.githubusercontent.com/u/151131799?v=4&size=100" width="100px" height="100px" alt="Nagi KaTou"/><br />_{<b>Nagi KaTou</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/issues?q=author%3Amumuzi6" title="Bug reports">🐛</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=mumuzi6" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/manovotn"><img src="https://avatars.githubusercontent.com/u/4181235?v=4&size=100" width="100px" height="100px" alt="Matej Novotny"/><br />_{<b>Matej Novotny</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/issues?q=author%3Amanovotn" title="Bug reports">🐛</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=manovotn" title="Tests">⚠️</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=manovotn" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://about.me/ravimeena"><img src="https://avatars.githubusercontent.com/u/12935461?v=4&size=100" width="100px" height="100px" alt="ravismash"/><br />_{<b>ravismash</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/issues?q=author%3Aravismash" title="Bug reports">🐛</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=ravismash" title="Tests">⚠️</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=ravismash" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://tauisilva.github.io/Portfolio-app/"><img src="https://avatars.githubusercontent.com/u/42608628?v=4&size=100" width="100px" height="100px" alt="Taui Silva Lima"/><br />_{<b>Taui Silva Lima</b>}</a><br /><a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=tauisilva" title="Tests">⚠️</a> <a href="https://github.com/quarkiverse/quarkus-mcp-server/commits?author=tauisilva" title="Code">💻</a></td> </tr> </tbody> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the all-contributors specification. Contributions of any kind welcome!

Footnotes

1. "Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools." ↩