______________________________________________________________________
MCP示例–Spring Boot客户端/服务器集成
此存储库包含 模块化通信协议（MCP）示例 使用\*\*Spring Boot\*\*构建的集成，演示了一个使用独立AI的自定义系统 MCP服务器 和 MCP客户端.
______________________________________________________________________
📦 项目结构
该项目包含 两个独立的Spring Boot应用程序:
/mcp-client
└── src/main/java/.../McpClientApplication.java
/mcp-server
└── src/main/java/.../McpServerApplication.java✔️ mcp服务器
一个公开MCP兼容端点的Spring Boot服务。 它充当提供数据、工具或模型响应的后端系统。
✔️ mcp客户端
连接到MCP服务器的Spring Boot客户端应用程序。 它演示了使用自定义MCP协议逻辑的AI辅助交互。
______________________________________________________________________
⚠️ 先决条件（非常重要）
要成功运行此应用程序，您需要 必须通过Docker桌面下载并运行Gemma 3模型.
步骤：
- 打开 Docker桌面
- 首选 扩展→ 模型 （或同等型号部分）
- 搜索 谷歌Gemma 3
- 下载模型
- 确保它是 在本地运行 因此MCP客户端可以访问它
如果不运行此模型，AI交互流将无法工作。
______________________________________________________________________
🚀 运行应用程序
1.启动MCP服务器
导航到 服务器 项目和运行：
./mvnw spring-boot:run或者直接运行main类：
McpServerApplication服务器将在其配置的端口上启动（通常 8080 除非更改）。
______________________________________________________________________
2.启动MCP客户端
导航到 客户端 项目和运行：
./mvnw spring-boot:run或者直接运行main类：
McpClientApplication客户端将初始化，连接到MCP服务器，并开始执行项目中定义的AI集成逻辑。
______________________________________________________________________
🧠 AI/MCP集成逻辑
该项目展示了：
- 创造一个 自定义MCP协议桥 春季靴
- 发送和接收结构化消息
- 将AI工作流程与自定义工具系统集成
- 使用客户端查询或操作服务器上的数据
您可以扩展客户端/服务器模块内的协议逻辑，以连接：
- LLM
- 工具API
- 内部服务
- 工作流引擎
______________________________________________________________________
🧪 测试暴露的API（手动开发者测试）
开发人员可以使用 发布 请求：
🔹 端点
POST http://localhost:8081/chat/ask🔹 请求正文（原始文本）
以纯文本形式发送请求正文。 例子：
[Postgres] give me some info on goku ?🔹 使用cURL
curl -X POST \
-H "Content-Type: text/plain" \
--data "[Postgres] give me some info on goku ?" \
http://localhost:8081/chat/ask______________________________________________________________________
⚙️ 配置
常见配置文件：
mcp-client/src/main/resources/application.yml
mcp-server/src/main/resources/application.properties这些可以定义：
- 服务器端口
- 客户端目标服务器URL
- 日志记录
- 凭证/令牌
- 模型配置
______________________________________________________________________
🧪 运行测试
运行所有测试：
./mvnw test______________________________________________________________________
📚 需求
- Java 17+
- Maven 3.9+
- 弹簧靴3.x
- 从Docker桌面下载并运行Gemma 3模型（必填）
______________________________________________________________________