金大哥 - crm-mcp-server MCP 详情

article

README

🚀 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 配置和部署。

crm-mcp-server