Quarkus MCP Agentic

🚀 单体アプリケーション + MCP = プロキシ型アプリケーション

このプロジェクトでは、Quarkus（超音速次原子 Java フレームワーク）とモデルコンテキストプロトコルを使用して、複数の MCP サーバーと Quarkus + LangChain4j を用いたシンプルなプロキシ型アプリケーションを実装しています。

Quarkus について詳しく知りたい場合は、公式ウェブサイトをご覧ください：https://quarkus.io/ 。

🚀 クイックスタート

📦 インストール

アプリケーションを開発モードで実行するには、以下の準備が必要です。

• node と npm をインストールします（これは mcp サービスを起動するために必要です）。推奨方法で こちら からシステムにインストールしてください。
• 組み込みのテレメトリを見たい場合は、コンテナ環境（例：Podman または Docker）が利用可能である必要があります。アプリケーションが実行されると、Dev UI から Grafana のリンクを見つけてアクセスできます。コンテナ環境がない場合は、application.properties 内のテレメトリ関連の部分をコメントアウトしてください。
• プロジェクトのルートディレクトリに playground という名前のフォルダを作成します（filesystem MCP サーバーを使用する場合）。または、application.properties 内の名前を変更しても構いませんが、このフォルダは存在する必要があります。

いくつかの MCP サービスには API キーが必要です。以下はキーを取得するためのリンクです：

• OpenAI - API キーを取得する
• Hugging Face - Hugging Face API キーを取得する

これらの情報を src/main/resources/application.properties ファイルに以下のように記載してください：

# OpenAI 設定
quarkus.langchain4j.mcp.openai.api-key=your-api-key
quarkus.langchain4j.mcp.openai.organization=your-organization-id

# Hugging Face 設定
quarkus.langchain4j.mcp.huggingface.api-key=your-hf-api-key

💻 使用例

基本的な使用法

アプリケーションのテストは以下のコマンドで行えます：

curl http://localhost:8080

大規模言語モデル（LLM）と会話するには、以下のようにします：

curl -X POST http://localhost:8080/api/chat \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "你能告诉我如何学习编程吗?"}]}'

📦 アプリケーションのパッケージングと実行

アプリケーションをパッケージングするには、以下のコマンドを実行します：

./mvnw package

これにより、target/quarkus-app/ ディレクトリに quarkus-run.jar ファイルが生成されます。ただし、これは uber-jar ではなく、依存関係は target/quarkus-app/lib/ ディレクトリにコピーされます。

パッケージングされたアプリケーションを実行するには、以下のコマンドを実行します：

java -jar target/quarkus-app/quarkus-run.jar

uber-jar をビルドするには、以下のコマンドを実行します：

./mvnw package -Dquarkus.package.type=uber-jar

これにより、すべての依存関係を含む単一の JAR ファイルを実行できます。

📄 ネイティブ実行可能ファイルの作成

ネイティブ実行可能ファイルを作成するには、以下のコマンドを実行します：

./mvnw package -Dnative

GraalVM がインストールされていない場合は、コンテナを使用してネイティブ実行可能ファイルをビルドできます：

./mvnw package -Dnative -Dquarkus.native.container-build=true

その後、ネイティブ実行可能ファイルを実行できます：

./target/research-1.0-SNAPSHOT-runner

ネイティブ実行可能ファイルのビルドについて詳しく知りたい場合は、https://quarkus.io/guides/maven-tooling をご覧ください。

📚 ドキュメント

関連ガイド

• LangChain4j モデルコンテキストプロトコルクライアント：ガイド
• LangChain4j OpenAI：ガイド