Crm MCP Server

🚀 Docker Setup Guide - CRM MCP Server

This guide explains how to build and deploy a Model Context Protocol (MCP) server using Docker images.

🚀 Quick Start

This project implements an MCP server using Spring AI. Its main functions include creating CRM marketing campaigns, setting target rules, creating email content, and setting campaign schedules.

✨ Features

• Create CRM marketing campaigns.
• Set target rules.
• Create email content.
• Set campaign schedules.

📦 Installation

Dockerfile Explanation

# A simple Dockerfile for building the MCP Server, using a local JAR file
FROM eclipse-temurin:17-jre-jammy

WORKDIR /app

# Set the time zone
ENV TZ=Asia/Seoul
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

# Copy the JAR file from the local build
COPY build/libs/mcpserver-0.0.1-SNAPSHOT.jar app.jar

# Configure to use standard input and output
ENTRYPOINT ["java", "-Xms512m", "-Xmx1g", "-jar", "app.jar"]

This Dockerfile has the following functions:

1. Use a lightweight image based on JDK 17.
2. Set the time zone to South Korea (Seoul).
3. Copy the JAR file generated by the local build into the image.
4. Configure to use standard input and output (STDIO).

Preparation

1. Ensure that Docker Desktop is installed.
2. You need a Docker Hub account (use the yoonbeopgong account).
3. Make sure you are logged in to Docker Hub:

   docker login
   

Build and Deployment on Linux/Mac

Run the following commands to build the image and push it to Docker Hub:

chmod +x build_and_push.sh
./build_and_push.sh

Build and Deployment on Windows

Run the following script:

build_and_push.bat

💻 Usage Examples

Basic Usage

To run the MCP server, use the following command:

docker run -i --rm yoonbeopgong/crm-mcp-server

Advanced Usage

When referencing the MCP server in a JSON configuration, you can do it like this:

{
  "mcpServers": {
    "crmMcpServer": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "yoonbeopgong/crm-mcp-server"
      ]
    }
  }
}

📚 Documentation

Testing on Linux/Mac

Run the following command to test:

chmod +x test-docker.sh
./test-docker.sh

Testing on Windows

Run the following script:

test-docker.bat

🔧 Technical Details

• The size of the Docker image depends on the requirements of the application.
• Environment variable configurations should be adjusted according to actual needs.
• In a production environment, additional security configurations are recommended.

📄 License

No license information provided in the original document.

Troubleshooting

Common Issues

1. Docker packaging fails
   • Check if the Dockerfile is correct.
   • Ensure that all dependencies are installed.
2. Container runs abnormally
   • Check the application logs.
   • Ensure that the configuration parameters are correct.
3. Image pull fails
   • Check the network connection.
   • Ensure that the image name is correct.

By following the above steps, you can successfully complete the Docker configuration and deployment of the MCP server.