Crm MCP Server

🚀 Docker 設置指南 - CRM MCP 服務器

本指南詳細說明了如何藉助 Docker 鏡像來構建和部署 Model Context Protocol (MCP) 服務器，幫助您高效完成服務器的配置與部署工作。

🚀 快速開始

本項目藉助 Spring AI 實現了 MCP 服務器，其主要功能涵蓋：

• 創建 CRM 營銷活動
• 設置目標規則
• 創建電子郵件內容
• 設置活動計劃

📦 安裝指南

Dockerfile 解釋

# 用於構建 MCP Server 的簡單 Dockerfile，使用本地 JAR 文件
FROM eclipse-temurin:17-jre-jammy

WORKDIR /app

# 設置時區
ENV TZ=Asia/Seoul
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

# 從本地構建複製 JAR 文件
COPY build/libs/mcpserver-0.0.1-SNAPSHOT.jar app.jar

# 配置使用標準輸入輸出
ENTRYPOINT ["java", "-Xms512m", "-Xmx1g", "-jar", "app.jar"]

此 Dockerfile 具備以下功能：

1. 採用 JDK 17 基礎的輕量級鏡像。
2. 將時區設定為韓國（首爾）。
3. 把本地構建生成的 JAR 文件複製到鏡像中。
4. 配置使用標準輸入輸出 (STDIO)。

準備工作

1. 確保 Docker Desktop 已安裝。
2. 需要 Docker Hub 賬戶（使用 yoonbeopgong 賬號）。
3. 確保已登錄 Docker Hub：

   docker login
   

Linux/Mac 上的構建與部署

運行以下命令構建鏡像並推送到 Docker Hub：

chmod +x build_and_push.sh
./build_and_push.sh

Windows 上的構建與部署

運行以下腳本：

build_and_push.bat

💻 使用示例

基礎用法

運行 MCP 服務器的命令如下：

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

高級用法

在 JSON 配置中引用 MCP 服務器時，可以這樣做：

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

🧪 測試

Linux/Mac 上的測試

運行以下命令進行測試：

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

Windows 上的測試

運行以下腳本：

test-docker.bat

⚠️ 注意事項

• Docker 鏡像大小取決於應用程序的需求。
• 環境變量配置應根據實際需求調整。
• 在生產環境中，建議額外的安全配置。

🛠️ 故障排除

常見問題

1. Docker 打包失敗
   • 檢查 Dockerfile 是否正確。
   • 確保所有依賴項已安裝。
2. 容器運行異常
   • 檢查應用程序日誌。
   • 確保配置參數無誤。
3. 鏡像拉取失敗
   • 檢查網絡連接。
   • 確保鏡像名稱正確。

通過以上步驟，您可以順利完成 MCP 服務器的 Docker 配置和部署。