🚀 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 具备以下功能：
- 采用 JDK 17 基础的轻量级镜像。
- 将时区设定为韩国（首尔）。
- 把本地构建生成的 JAR 文件复制到镜像中。
- 配置使用标准输入输出 (STDIO)。
准备工作
- 确保 Docker Desktop 已安装。
- 需要 Docker Hub 账户（使用
yoonbeopgong账号）。 - 确保已登录 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 镜像大小取决于应用程序的需求。
- 环境变量配置应根据实际需求调整。
- 在生产环境中，建议额外的安全配置。
🛠️ 故障排除
常见问题
- Docker 打包失败
- 检查 Dockerfile 是否正确。
- 确保所有依赖项已安装。
- 容器运行异常
- 检查应用程序日志。
- 确保配置参数无误。
- 镜像拉取失败
- 检查网络连接。
- 确保镜像名称正确。
通过以上步骤，您可以顺利完成 MCP 服务器的 Docker 配置和部署。