이 Quarkus 확장은 개발자가 MCP[^1] 서버 기능을 쉽게 구현할 수 있도록 선언형 및 프로그래밍형 API를 모두 제공합니다.

[^1]: _“모델 컨텍스트 프로토콜(MCP)은 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 개방형 프로토콜입니다.” _

[! 참고] LangChain4j 프로젝트는 MCP 클라이언트 기능을 저수준 프로그래밍 API로 제공하거나 AI 기반 애플리케이션에 완전하게 통합하는 기능을 제공합니다.

시작해

단계 #1

POM 파일에 다음과 같은 의존성을 추가하세요:

[! 참고] 이 의존성에는 레거시 "HTTP/SSE"와 “Streamable HTTP” 전송 모두가 포함됩니다. STDIO 전송을 사용하고 싶다면 quarkus-mcp-server-stdio artifactId를 사용하세요. 자세한 내용은 문서의 전송 섹션도 참고하세요.

단계 #2

CDI 빈즈의 비즈니스 methods_으로 표현되는 서버 기능(프롬프트, 리소스, 도구)을 추가_annotated.

단계 #3

Quarkus 앱을 실행하고 즐겁게 즐기세요!

문서

전체 문서는 [https://quarkiverse.github.io/quarkiverse-docs/quarkus-mcp-server/dev/index.html.에서 확인할 수 있습니다.

기여자들 ✨

이 멋진 분들께 감사드립니다 (이모지 키):

Quarkus MCP Server

This Quarkus extension provides both declarative and programmatic APIs that enable developers to easily implement MCP[^1] server features.

[^1]: “Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools.”

[!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:

    io.quarkiverse.mcp
    quarkus-mcp-server-http
    ${quarkus-mcp-server-version}

[!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