Parasol MCP Demo

Parasol--演示

此存储库包含两个基于Quarkus的项目，它们协同工作：

• mcp-server --一个模型上下文协议（MCP）工具服务器，它公开了应用程序在推理过程中可以调用的工具。在端口8088上运行。
• parasol-app --主要应用程序演示了人工智能辅助索赔处理，包括聊天/RAG、网络套接字、电子邮件、可观察性和数据库集成。它连接到MCP工具服务器。默认情况下在端口8080上运行。

这两个项目都是标准的Maven构建，您可以在开发模式下单独运行。

项目如何互动

parasol-app 使用LangChain4j的MCP客户端调用由提供的工具 mcp-server 通过HTTP。

• parasol-app 配置为在以下位置到达MCP端点http://localhost:8088/mcp（参见 parasol-app/src/main/resources/application.yml → quarkus.langchain4j.mcp.tools).
• 你必须开始 mcp-server 首先(./mvnw quarkus:dev)，然后开始 parasol-app (./mvnw quarkus:dev)因此工具列表/握手成功。

- 确保有 OPENAI_API_KEY 环境变量设置为您的OpenAI API键。 - 可观测性堆栈（Grafana/Tempo/Loki/等）在两者之间共享。

高级演示流程

1. 用户与 parasol-app

- 前往索赔处，打开聊天机器人，问一些类似的问题 Please send an email to the claimant notifying them that adjuster Emmet Brown has been assigned to the claim.

1. 机器人可能会说它发送了电子邮件。如果是，问它是否 _真的_ 它应该说它不知道该怎么做。
2. 打开 SendEmailService 并取消注释该行 @dev.langchain4j.agent.tool.Tool(name = "sendEmail", value = "Sends an email")
3. 在 mcp-server dev模式，点击 s 按键触发重新加载。
4. 在 parasol-app dev模式，点击 s 按键触发重新加载。
5. 返回聊天机器人并刷新浏览器页面，重新询问 Please send an email to the claimant notifying them that adjuster Emmet Brown has been assigned to the claim.
6. 转到 mcp服务器邮件坑开发UI 并查看发送的电子邮件。

先决条件

确保以下内容已安装并可用：

• Java 21+
• Maven 3.9+
• Docker或Podman（适用于Quarkus开发服务：Postgres、Mailpit、LGTM等）

环境变量：

• OPENAI_API_KEY --如果使用OpenAI（默认配置），则需要。使用Olama配置文件时不需要。

有用的URL

• parasol-app 开发用户界面：http://localhost:8080/q/dev
• parasol-app OpenAPI/Swagger用户界面：http://localhost:8080/q/swagger-ui
• MCP工具服务器基础：http://localhost:8088/mcp

笔记：

• 在开发模式下，如果Docker/Podman可用，Quarkus开发服务将自动启动依赖容器（例如Postgres、Mailpit、LGTM）。
• 这 parasol-app 在开发过程中使用Quinoa自动构建前端；Node/npm按照application.yml中的指定进行配置。