Quarkus MCP Agentic

🚀 單體應用 + MCP = 代理型應用

本項目藉助 Quarkus（超音速次原子 Java 框架）與 模型上下文協議 實現了一個簡單的代理型應用，運用了多個 MCP 服務器以及 Quarkus + LangChain4j。

如果你想深入瞭解 Quarkus，可訪問其官方網站： https://quarkus.io/ 。

🚀 快速開始

📦 安裝指南

你需要安裝 node 和 npm（用於啟動 mcp 服務），請按照 此處 的推薦方法將其安裝到你的系統中。

你還需要一個可用的容器環境（例如 Podman 或 Docker），若你想查看內置的 telemetry。應用程序運行後，你可通過 Dev UI 查找 Grafana 鏈接進行訪問。若沒有容器環境，請註釋掉 application.properties 中與 telemetry 相關的部分。

在項目根目錄下創建名為 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：指南