MCP Campaign Server
A Spring Boot MCP (Model Context Protocol) server that provides insurance marketing campaign management capabilities for Claude AI integration.
Features
Audience Targeting: AI-powered recommendations for insurance marketing audience segmentation
Campaign Content: Personalized content recommendations for different insurance products and channels
Claude Inspector Integration: Support for Claude Inspector tool queries
MCP Protocol: Full MCP server implementation with WebSocket support
REST API: Additional HTTP endpoints for direct integration
Quick Start
Prerequisites
Java 17 or higher
Maven 3.6 or higher
Installation
Clone the repository:
git clone <repository-url>
cd Mcp_Campaign
Build the project:
# If you have corporate Maven repository issues, use the startup script
./start.sh
# Or manually with custom settings
mvn clean compile --settings temp-settings.xml
Run the application:
The server will start on port 8080 with WebSocket endpoint at ws://localhost:8080/api/mcp
Corporate Repository Issues
If you encounter corporate Maven repository connectivity issues, create a temporary settings file:
# Create temp-settings.xml with Maven Central only
cat > temp-settings.xml << EOF
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<mirrors>
<mirror>
<id>central</id>
<name>Maven Central</name>
<url>https://repo1.maven.org/maven2</url>
<mirrorOf>*</mirrorOf>
</mirror>
</mirrors>
</settings>
EOF
# Then build with custom settings
mvn clean compile --settings temp-settings.xml
MCP Tools
The server provides the following MCP tools for Claude integration:
1. audience_targeting
Provides audience targeting criteria recommendations based on user requirements.
Input Parameters:
requirements (required): User requirements for audience targeting
insurance_type (optional): Type of insurance (life, health, auto, property, etc.)
campaign_objective (optional): Campaign objective (acquisition, retention, upselling, etc.)
Example Usage:
{
"name": "audience_targeting",
"arguments": {
"requirements": "Target young professionals aged 25-35 who are interested in life insurance",
"insurance_type": "life_insurance",
"campaign_objective": "acquisition"
}
}
2. campaign_content_recommendation
Recommends personalized campaign content for insurance marketing.
Input Parameters:
audience_criteria (required): Target audience criteria object
insurance_type (required): Type of insurance product
channel (optional): Marketing channel (email, sms, social_media, etc.)
campaign_goal (optional): Campaign goal (awareness, conversion, retention, etc.)
Example Usage:
{
"name": "campaign_content_recommendation",
"arguments": {
"audience_criteria": {
"minAge": 25,
"maxAge": 35,
"incomeRange": ["middle_income", "high_income"]
},
"insurance_type": "life_insurance",
"channel": "email",
"campaign_goal": "conversion"
}
}
3. inspector_query
Executes queries for Claude Inspector tool integration.
Input Parameters:
Example Usage:
{
"name": "inspector_query",
"arguments": {
"query": "Analyze the effectiveness of recent insurance marketing campaigns"
}
}
REST API Endpoints
Health Check
GET /api/campaigns/health
List Available Tools
Audience Recommendation
POST /api/campaigns/audience/recommend
Content-Type: application/json
{
"requirements": "Target young professionals for life insurance",
"insurance_type": "life_insurance",
"campaign_objective": "acquisition"
}
Content Recommendation
POST /api/campaigns/content/recommend
Content-Type: application/json
{
"audience_criteria": {
"minAge": 25,
"maxAge": 35,
"incomeRange": ["middle_income"]
},
"insurance_type": "life_insurance",
"channel": "email",
"campaign_goal": "conversion"
}
AI Integration
Cline (VS Code) Integration
快速设置:
手动配置:
在 ~/.cline/config.json 中添加配置：
{
"mcpServers": {
"insurance-campaign": {
"command": "java",
"args": ["-jar", "/path/to/mcp-campaign-server-1.0.0.jar"],
"env": {"SERVER_PORT": "8080"}
}
}
}
重启VS Code
在Cline中开始对话并使用工具
使用示例:
请帮我分析一下针对年轻专业人士的人寿保险营销活动的人群定位策略
Claude Desktop Integration
Add the MCP server configuration to your Claude Desktop settings:
{
"mcpServers": {
"insurance-campaign": {
"command": "java",
"args": ["-jar", "path/to/mcp-campaign-server.jar"],
"env": {
"SERVER_PORT": "8080"
}
}
}
}
WebSocket Connection
Connect to the MCP server via WebSocket at:
ws://localhost:8080/api/mcp
Configuration
The application can be configured via application.yml:
server:
port: 8080
mcp:
server:
name: "Insurance Campaign MCP Server"
version: "1.0.0"
protocol-version: "2024-11-05"
websocket:
path: "/mcp"
allowed-origins: "*"
Development
Project Structure
src/main/java/com/insurance/mcp/
├── McpCampaignServerApplication.java # Main application class
├── config/
│ └── WebSocketConfig.java # WebSocket configuration
├── controller/
│ └── CampaignController.java # REST endpoints
├── handler/
│ └── McpWebSocketHandler.java # MCP WebSocket handler
├── model/
│ ├── McpRequest.java # MCP request model
│ ├── McpResponse.java # MCP response model
│ ├── McpTool.java # MCP tool model
│ └── campaign/
│ ├── AudienceCriteria.java # Audience targeting model
│ └── CampaignContent.java # Campaign content model
└── service/
├── McpToolService.java # MCP tool service
└── campaign/
├── AudienceTargetingService.java # Audience targeting logic
└── CampaignContentService.java # Content recommendation logic
Building and Testing
# Run tests
mvn test
# Build JAR
mvn clean package
# Run with custom profile
mvn spring-boot:run -Dspring-boot.run.profiles=dev
Insurance Types Supported
Life Insurance
Health Insurance
Auto Insurance
Property Insurance
Travel Insurance
Marketing Channels Supported
Email
SMS
Social Media
Push Notifications
Direct Mail
License
This project is licensed under the MIT License.
mcp_campaign_server