单体应用 + 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：指南