Skip to main content
Glama

Insurance Campaign MCP Server

by AlandeXiong

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

  1. Clone the repository:

git clone <repository-url> cd Mcp_Campaign
  1. 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
  1. Run the application:

mvn spring-boot:run

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:

  • query (required): Query for Claude Inspector tool

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

GET /api/campaigns/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

快速设置:

./setup_cline.sh

手动配置:

  1. ~/.cline/config.json 中添加配置:

{ "mcpServers": { "insurance-campaign": { "command": "java", "args": ["-jar", "/path/to/mcp-campaign-server-1.0.0.jar"], "env": {"SERVER_PORT": "8080"} } } }
  1. 重启VS Code

  2. 在Cline中开始对话并使用工具

使用示例:

请帮我分析一下针对年轻专业人士的人寿保险营销活动的人群定位策略

Claude Desktop Integration

  1. 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

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables AI-powered insurance marketing campaign management with audience targeting recommendations and personalized content generation for different insurance products and marketing channels.

  1. Features
    1. Quick Start
      1. Prerequisites
      2. Installation
      3. Corporate Repository Issues
    2. MCP Tools
      1. 1. audience_targeting
      2. 2. campaign_content_recommendation
      3. 3. inspector_query
    3. REST API Endpoints
      1. Health Check
      2. List Available Tools
      3. Audience Recommendation
      4. Content Recommendation
    4. AI Integration
      1. Cline (VS Code) Integration
      2. Claude Desktop Integration
      3. WebSocket Connection
    5. Configuration
      1. Development
        1. Project Structure
        2. Building and Testing
      2. Insurance Types Supported
        1. Marketing Channels Supported
          1. License
            1. mcp_campaign_server

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/AlandeXiong/mcp_campaign_server'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server