Quarkiverse Quarkus MCP Server

🚀 Quarkus モデルコンテキストプロトコル（MCP）サーバー拡張

"モデルコンテキストプロトコル (MCP) は、大規模言語モデル (LLM) アプリケーションと外部データソースおよびツールとのシームレスな統合を可能にするオープンプロトコルです。"

この拡張機能は、開発者がMCPサーバー機能を簡単に実装できる宣言型APIを提供します。

🚀 クイックスタート

ステップ1：プロジェクトのPOMファイルに依存関係を追加する

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

ステップ2：CDIビーン内の注釈付き業務メソッドでサーバー機能（プロンプト、リソース、ツール）を定義する

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.Tool;
import io.quarkiverse.mcp.server.TextContent;

// このクラスは自動的に @Singleton CDIビーンとして登録されます
public class ServerFeatures {

    @Inject
    CodeService codeService;

    @Tool
    TextContent toLowerCase(String value) {
        return new TextContent(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")
    BlobResourceContents alpha(String uri) throws IOException{
        return BlobResourceContents.create(uri, Files.readAllBytes(Paths.ALPHA));
    }

}

ステップ3：Quarkusアプリケーションを実行する

⚠️ 重要提示

現在はHTTP/SSEトランスポートのみがサポートされています。

完全なドキュメントを読むことができます。

✨ 主な機能

この拡張機能により、開発者は簡単にMCPサーバー機能を実装できます。具体的には、CDIビーン内の注釈付き業務メソッドを使用して、プロンプト、リソース、ツールを定義できます。

📦 インストール

プロジェクトのPOMファイルに以下の依存関係を追加することで、この拡張機能をインストールできます。

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

💻 使用例

基本的な使用法

以下のコードは、サーバー機能を定義する基本的な例です。

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.Tool;
import io.quarkiverse.mcp.server.TextContent;

// このクラスは自動的に @Singleton CDIビーンとして登録されます
public class ServerFeatures {

    @Inject
    CodeService codeService;

    @Tool
    TextContent toLowerCase(String value) {
        return new TextContent(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")
    BlobResourceContents alpha(String uri) throws IOException{
        return BlobResourceContents.create(uri, Files.readAllBytes(Paths.ALPHA));
    }

}

📚 ドキュメント

完全なドキュメントはこちらを参照してください。

🔧 技術詳細

この拡張機能は、Quarkusフレームワークを使用して開発されており、CDI（Contexts and Dependency Injection）を利用してサーバー機能を定義します。具体的には、注釈付きの業務メソッドを使用して、プロンプト、リソース、ツールを定義できます。

📄 ライセンス

原文書にライセンス情報が記載されていないため、このセクションは省略されています。

🔗 関連リンク

• モデルコンテキストプロトコル公式サイト
• Quarkus MCPサーバー拡張のドキュメント

🌟 貢献者

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