Docker 设置指南 - CRM MCP 服务器

本指南介绍了如何将 Model Context Protocol (MCP) 服务器构建为 Docker 镜像并进行部署。

1. 项目概览

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

• CRM 活动创建
• 目标规则设置
• 电子邮件内容生成
• 活动日程安排

2. Docker 设置内容

Dockerfile 说明

# Simple Dockerfile for MCP Server that uses local JAR file
FROM eclipse-temurin:17-jre-jammy

WORKDIR /app

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

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

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

此 Dockerfile 执行以下操作：

1. 使用基于 JDK 17 的轻量级镜像。
2. 将时区设置为韩国（Asia/Seoul）。
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"
      ],
      "env": {}
    }
  }
}

5. 测试

镜像测试

可以运行以下脚本来测试 Docker 镜像是否正常工作：

Linux/Mac:

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

Windows:

test-docker.bat

6. 注意事项和提示

1. Docker 镜像仅包含 JAR 文件，因此非常轻量。
2. 由于是标准输入/输出方式，因此不暴露任何端口。
3. 要推送到 Docker Hub，必须登录。
4. 此设置适用于开发/测试环境，生产环境可能需要额外的安全设置。

7. 问题解决

Docker 构建失败时

1. 检查 JDK 版本：确保项目设置为 Java 17。
2. 检查 Gradle 构建：运行 ./gradlew build 以确保生成 JAR 文件。
3. 检查 Docker 日志：运行 docker build -t yoonbeopgong/crm-mcp-server . --no-cache 尝试在没有缓存的情况下构建。

容器运行失败时

1. 检查日志：使用 docker logs [container_id] 检查日志。
2. 检查 JAR 文件是否存在：确保 Dockerfile 引用了正确路径的 JAR 文件。