Crm MCP Server

🚀 Docker設定ガイド - CRM MCPサーバー

このガイドでは、Dockerイメージを使用してModel Context Protocol (MCP)サーバーを構築およびデプロイする方法を説明します。

🚀 クイックスタート

このガイドを参照することで、Dockerを用いてMCPサーバーを構築・デプロイし、CRMの各種機能を実現できます。

✨ 主な機能

本プロジェクトでは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設定とデプロイを円滑に完了することができます。