Quarkus Model Context Protocol (MCP) Server

Quarkus MCP Server

この Quarkus エクステンションは、開発者が MCP¹ サーバーの機能を簡単に実装できるようにする、宣言型およびプログラム型の API を提供します。

メモ

LangChain4j プロジェクトは、低レベルのプログラム型 API として、または AI を活用したアプリケーションへのフル機能の統合として、MCP クライアント機能を提供します。

はじめに

ステップ #1

次の依存関係を POM ファイルに追加します。

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

メモ

この依存関係には、従来の「HTTP/SSE」トランスポートと「Streamable HTTP」トランスポートの両方が含まれます。代わりに STDIO トランスポートを使用する場合は、quarkus-mcp-server-stdio artifactId を使用してください。詳細については、ドキュメントのトランスポートのセクションもご覧ください。

ステップ #2

CDI Bean の_アノテーション付きビジネスメソッド_として、サーバー機能（プロンプト、リソース、ツール）を追加します。

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"));
    }

}

ステップ #3

Quarkus アプリを実行して、楽しみましょう！

ドキュメント

ドキュメント全文は https://quarkiverse.github.io/quarkiverse-docs/quarkus-mcp-server/dev/index.html でご覧いただけます。

コントリビューター ✨

次の素晴らしい方々に感謝します（絵文字キー）：

Martin Kouba 💻 🚧	Georgios Andrianakis 💻	Max Rydahl Andersen 💡	Rostislav Svoboda 💻	George Gastaldi 🚇	Jan Martiska 📖	Ioannis Canellos 💻
Sergey Beryozkin 💡	Konstantin Pavlov ⚠️ 🚇	Martijn van Duijnhoven 💻 ⚠️ 📖	Pierre Beitz 💻 ⚠️	Matthieu Recouly 📖	Willem Jan Glerum 🚇	Sascha Steffen 💻 ⚠️
Clement Escoffier 📖	Rolfe Dlugy-Hegwer 📖 💻	Bruno Baptista 📖 💻	Moayad Alyaghshi 🐛 💻	David Kornel 🐛 💻	Ian Stewart 🐛 💻	Eric Hare 🐛 💻
Nagi KaTou 🐛 💻	Matej Novotny 🐛 ⚠️ 💻

このプロジェクトは、all-contributors の仕様に準拠しています。あらゆる種類の貢献を歓迎します！

Footnotes

1. 「Model Context Protocol（MCP）は、LLM アプリケーションと外部データソースやツールをシームレスに統合するオープンプロトコルです。」 ↩