Insurance Campaign MCP Server

# HTTP Stream支持总结 ## ✅ 已完成的工作 ### 1. 添加HTTP Stream支持 - ✅ 创建了 `McpHttpStreamHandler.java` - Spring Boot集成的HTTP Stream处理器 - ✅ 创建了 `McpHttpStreamController.java` - HTTP Stream REST控制器 - ✅ 创建了 `McpHttpStreamApplication.java` - 独立的HTTP Stream应用程序 - ✅ 创建了 `start_http_stream.sh` 启动脚本 - ✅ 更新了配置文件支持HTTP Stream模式 ### 2. 三重架构支持 现在MCP Campaign服务器支持三种连接方式： #### WebSocket方式 - 通过HTTP服务器和WebSocket连接 - 适合网络环境下的集成 - 支持多客户端连接 #### Stdio方式 - 通过标准输入输出流进行通信 - 适合本地集成和开发 - 更好的兼容性和稳定性 #### HTTP Stream方式 ✅ 新增 - 通过HTTP Server-Sent Events (SSE)进行通信 - 基于HTTP协议，兼容性更好 - 支持多客户端连接和自动重连 - 更好的错误处理机制 ## 🚀 使用方法 ### 启动HTTP Stream服务器 ```bash cd /Users/xiongjian/project/Mcp_Campaign ./start_http_stream.sh [port] ``` 默认端口：8081 ### 配置Cline使用HTTP Stream 在 `~/.cline/config.json` 中添加： ```json { "mcpServers": { "insurance-campaign": { "command": "mvn", "args": [ "exec:java", "-Dexec.mainClass=com.insurance.mcp.McpHttpStreamApplication", "-Dexec.args=8081" ], "cwd": "/Users/xiongjian/project/Mcp_Campaign" } } } ``` ### 或者使用启动脚本 ```json { "mcpServers": { "insurance-campaign": { "command": "./start_http_stream.sh", "args": ["8081"], "cwd": "/Users/xiongjian/project/Mcp_Campaign" } } } ``` ## 🧪 测试验证 ### 编译测试 ```bash mvn clean compile # ✅ BUILD SUCCESS - 编译成功 ``` ### 功能测试 HTTP Stream服务器支持所有原有的MCP工具： - `audience_targeting` - 人群定位 - `campaign_content_recommendation` - 内容推荐 - `inspector_query` - Inspector查询 ### API端点测试 #### 独立模式 - **SSE连接**: `http://localhost:8081/connect` - **健康检查**: `http://localhost:8081/health` #### Spring Boot集成模式 - **SSE连接**: `http://localhost:8080/mcp-stream/connect` - **发送请求**: `POST http://localhost:8080/mcp-stream/request` - **连接管理**: `GET http://localhost:8080/mcp-stream/connections` ## 📊 架构对比 | 特性 | WebSocket | Stdio | HTTP Stream | |------|-----------|-------|-------------| | 协议 | WebSocket | 标准输入输出 | HTTP/SSE | | 多客户端 | 支持 | 不支持 | 支持 | | 重连机制 | 手动 | 不适用 | 自动 | | 兼容性 | 中等 | 高 | 高 | | 调试难度 | 中等 | 简单 | 简单 | | 网络依赖 | 需要 | 不需要 | 需要 | | 错误处理 | 中等 | 简单 | 优秀 | ## 🎯 推荐使用场景 ### HTTP Stream方式推荐用于： - ✅ 需要多客户端连接 - ✅ 需要自动重连机制 - ✅ 需要更好的错误处理 - ✅ 基于HTTP协议的集成 - ✅ 需要流式数据传输 ### Stdio方式推荐用于： - ✅ 本地开发和测试 - ✅ 简单的单客户端集成 - ✅ 避免网络连接问题 ### WebSocket方式推荐用于： - ✅ 实时双向通信需求 - ✅ 网络环境下的集成 - ✅ 多客户端连接需求 ## 🔧 故障排除 ### 常见问题 1. **端口占用** ```bash lsof -i :8081 ``` 2. **SSE连接失败** - 检查服务器是否启动 - 检查防火墙设置 - 验证端口是否正确 3. **MCP连接超时** - 使用HTTP Stream方式 - 检查网络连接 - 验证配置格式 ### 调试技巧 1. **测试SSE连接** ```bash curl -N http://localhost:8081/connect ``` 2. **测试健康检查** ```bash curl http://localhost:8081/health ``` 3. **查看连接状态** ```bash curl http://localhost:8080/mcp-stream/connections ``` ## 📁 文件结构 ``` src/main/java/com/insurance/mcp/ ├── McpCampaignServerApplication.java # Spring Boot主应用 ├── McpStdioApplication.java # Stdio独立应用 ├── McpHttpStreamApplication.java # ✅ 新增：HTTP Stream独立应用 ├── handler/ │ ├── McpWebSocketHandler.java # WebSocket处理器 │ ├── McpStdioHandler.java # Stdio处理器 │ └── McpHttpStreamHandler.java # ✅ 新增：HTTP Stream处理器 ├── controller/ │ ├── CampaignController.java # REST控制器 │ └── McpHttpStreamController.java # ✅ 新增：HTTP Stream控制器 ├── service/ │ └── McpToolService.java # MCP工具服务 └── model/ # MCP协议模型 启动脚本： ├── start.sh # WebSocket方式启动 ├── start_stdio.sh # Stdio方式启动 ├── start_http_stream.sh # ✅ 新增：HTTP Stream方式启动 ├── update_to_http_stream.sh # ✅ 新增：配置更新脚本 └── one_click_fix.sh # 一键修复脚本 ``` ## 🎉 总结 现在您的MCP Campaign服务器完全支持HTTP Stream方式！ **主要优势：** - ✅ 基于HTTP协议，兼容性更好 - ✅ 支持Server-Sent Events (SSE) - ✅ 支持多客户端连接 - ✅ 自动重连机制 - ✅ 更好的错误处理 - ✅ 流式数据传输 **下一步：** 1. 选择适合的连接方式（推荐HTTP Stream） 2. 更新Cline配置 3. 重启VS Code 4. 开始使用保险营销工具 HTTP Stream方式是推荐的集成方式之一，特别适合需要稳定连接和多客户端支持的场景！