Docker 设置指南 - CRM MCP 服务器

本指南说明了如何使用 Docker 镜像构建和部署 Model Context Protocol (MCP) 服务器。

1. 项目概述

本项目使用 Spring AI 实现了 MCP 服务器，主要功能包括：

• 创建 CRM 营销活动
• 设置目标规则
• 创建电子邮件内容
• 设置活动计划

2. Docker 配置说明

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)。

3. 构建与部署方法

准备工作

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

4. 使用方法

运行 MCP 服务器的命令如下：

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

配置文件中的使用方法

在 JSON 配置中引用 MCP 服务器时，可以这样做：

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

5. 测试

Linux/Mac 上的测试

运行以下命令进行测试：

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

Windows 上的测试

运行以下脚本：

test-docker.bat

6. 注意事项

• Docker 镜像大小取决于应用程序的需求。
• 环境变量配置应根据实际需求调整。
• 在生产环境中，建议额外的安全配置。

7. 故障排除

常见问题

1. Docker 打包失败

   • 检查 Dockerfile 是否正确。
   • 确保所有依赖项已安装。

2. 容器运行异常

   • 检查应用程序日志。
   • 确保配置参数无误。

3. 镜像拉取失败

   • 检查网络连接。
   • 确保镜像名称正确。

通过以上步骤，您可以顺利完成 MCP 服务器的 Docker 配置和部署。