convez.ai
MCP ServerIntegração & APIsIntermediário
quarkiverse

Quarkus MCP Server

quarkiverse/quarkus-mcp-server

Implemente servidores MCP em Java/Quarkus com anotações simples

Ver no GitHub
BomPluginScore · de 0 a 100

Extensão Quarkus que simplifica a implementação de servidores MCP (Model Context Protocol) com APIs declarativas e programáticas. Permite expor ferramentas, prompts e recursos para integração com aplicações LLM através de anotações Java em beans CDI.

Instalação

$npx convez-ai quarkiverse/quarkus-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
204
Forks
76
Acompanhando
6
Saúde
50%
Último commit
há 3 dias
Versão
2.1.0.CR1
Issues abertas
21
Contribuidores
30

Casos de uso

  • Criar servidores MCP para integração com Claude e outras aplicações LLM
  • Expor ferramentas e recursos internos via Protocol MCP
  • Construir backends de IA com Quarkus usando padrões declarativos

Veredito

MCP Server robusto e bem documentado que torna acessível a implementação do protocolo em ecossistema Java. Ideal para desenvolvedores Quarkus que precisam integrar suas aplicações com clientes MCP, especialmente Claude.

README

A tradução para o português deste README ainda está na fila.

Quarkus MCP Server

All Contributors

Version

This Quarkus extension provides both declarative and programmatic APIs that enable developers to easily implement MCP1 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):

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." ↩

Ver o original no GitHub

Bom para

Relacionados