Eulerian Marketing Platform MCP

🚀 オイラリアンマーケティングプラットフォームMCPサーバー

モデルコンテキストプロトコル（MCP）のプロキシサーバーです。このサーバーは、AIアシスタント（Claude Desktop、Gemini CLIなど）とリモートのオイラリアンマーケティングプラットフォームMCPサーバーを橋渡しします。このプロキシは認証を処理し、リクエストを転送し、リモートのオイラリアンインスタンスに対するローカルのMCPインターフェイスを提供します。

🚀 クイックスタート

このサーバーは、ローカルのMCPクライアントとリモートのオイラリアンマーケティングプラットフォームサーバーの間で透過的なプロキシとして機能します。

┌─────────────┐        ┌──────────────────┐        ┌────────────────┐
│   Claude    │ ◄─────►│  このMCPプロキシ  │◄─────► │ リモートオイラリアン │
│   Desktop   │  stdio │  (ローカル)       │  HTTP  │  MCPサーバー    │
└─────────────┘        └──────────────────┘        └────────────────┘

プロキシの機能:

• 🔐 リモートのオイラリアンサーバーとの認証を処理します。
• 📡 Bearerトークンを使用してHTTP経由でMCPリクエストを転送します。
• 🛠️ リモートのツールとリソースをAIアシスタントに公開します。
• 📝 デバッグ用の包括的なログを提供します。
• ⚡ 非同期HTTPを使用してパフォーマンスを向上させます。

✨ 主な機能

• 🔌 プロキシアーキテクチャ：HTTPを介してローカルのMCPクライアントをリモートのオイラリアンMCPサーバーに接続します。
• 🔐 セキュアな認証：リモートサーバーへのアクセスにBearerトークン認証を使用します。
• 🌐 クロスプラットフォーム対応：Windows、Linux、macOSで動作します。
• 🤖 複数のAIクライアント：Claude DesktopやGemini CLIなどと互換性があります。
• 📝 包括的なログ記録：すべてのリクエストとレスポンスをログに記録してデバッグに役立てます。
• ⚡ 非同期HTTP：httpxを使用した非ブロッキングリクエストでパフォーマンスを向上させます。
• 🛠️ ツールの自動検出：リモートのツールを自動的に検出して公開します。
• ⏱️ タイムアウトの設定可能：リクエストのタイムアウトを調整できます。

🔧 事前準備

• Python 3.10以上
• リモートのオイラリアンマーケティングプラットフォームMCPサーバーへのアクセス（HTTPエンドポイント）
• リモートサーバーの有効な認証トークン
• 以下のAIクライアントのいずれか：
  • Claude Desktop (Windows, macOS, Linux)
  • Gemini CLI
  • Codex CLI (macOS, Linux)
  • Claude Code (macOS, Linux)
  • Cursor (Windows, macOS, Linux)
  • GitHub Copilotを搭載したVS Code (Windows, macOS, Linux)

📦 利用可能なツール

オイラリアンAPIでサポートされているすべてのAPIエンドポイントは、現在のMCPを通じてクエリを実行できます。

📦 インストール

クイックスタート（推奨）

このMCPサーバーを使用する最も簡単な方法は、pipを使用することです。

pipを使用したインストール

パッケージをグローバルにインストールする場合は、以下のコマンドを実行します。

pip install eulerian-marketing-platform

ソースからのインストール

git clone https://github.com/EulerianTechnologies/eulerian-marketing-platform-mcp.git
cd eulerian-marketing-platform-mcp
pip install -e .

🛠️ 設定

必須の環境変数

• EMP_API_ENDPOINT：リモートのオイラリアンマーケティングプラットフォームMCPサーバーのURL（HTTPエンドポイント）
  • 例: https://dem.api.eulerian.com/mcp
• EMP_API_TOKEN：リモートサーバーの認証トークンで、オイラリアンアカウントに関連付けられたトークンです。

オプションの環境変数

• EMP_LOG_FILE：ログファイルの場所（デフォルト: /tmp/eulerian-mcp-proxy.log）
• EMP_TIMEOUT：リクエストのタイムアウト時間（秒）（デフォルト: 300）

.envファイルの例

プロジェクト内に.env.exampleファイルを作成します。

# 必須
EMP_API_ENDPOINT=https://your-eulerian-instance.com/mcp
EMP_API_TOKEN=your_authentication_token_here

# オプション
EMP_LOG_FILE=/var/log/eulerian-mcp-proxy.log
EMP_TIMEOUT=600

📋 クライアント別のセットアップ手順

1. Claude Desktop

Claude Desktopは、stdioトランスポートを介してローカルのMCPサーバーをサポートしています。

設定ファイルの場所

• Windows：%APPDATA%\Claude\claude_desktop_config.json
• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

セットアップ手順

1. Claude Desktopを開く
2. 設定にアクセスする：
   • Claudeメニュー → Settings → Developer → Edit Configをクリックする
   • または、上記の場所にあるJSONファイルを手動で編集する
3. サーバーの設定を追加する：

{
  "mcpServers": {
    "eulerian-marketing-platform": {
      "command": "python",
      "args": ["-m", "eulerian_marketing_platform.server"],
      "env": {
        "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp",
        "EMP_API_TOKEN": "your_authentication_token_here"
      }
    }
  }
}

4. Claude Desktopを再起動する
5. 接続を確認する：
   • 右下隅にハンマー/ツールのアイコン（🔨）が表示されるのを確認する
   • それをクリックして、利用可能なオイラリアンツールを表示する
   • Claudeに「What Eulerian Marketing Platform tools do you have access to?」と尋ねる

プラットフォーム固有の注意事項

Windows：

• 実行ダイアログ (Win + R) を開き、%APPDATA%\Claude を入力して設定ディレクトリに素早く移動できます。
• ローカルインストールを使用する場合、PythonがPATHに含まれていることを確認してください。

Linux：

• 設定ディレクトリが最初は存在しない場合があります。mkdir -p ~/.config/Claude で作成してください。

macOS：

• Finderを使用して設定にアクセスできます。Cmd + Shift + G → ~/Library/Application Support/Claude/ と入力します。

2. Gemini CLI

Gemini CLIは、設定ファイルを通じてMCPサーバーをサポートしています。

事前準備

まだGemini CLIをインストールしていない場合は、以下のコマンドを実行してインストールします。

npm install -g @google/gemini-cli

設定ファイルの場所

~/.gemini/settings.json

セットアップ手順

1. 設定ファイルを作成または編集する：

# ディレクトリが存在しない場合は作成する
mkdir -p ~/.gemini

# 設定ファイルを編集する
nano ~/.gemini/settings.json

2. MCPサーバーの設定を追加する：

{
  "mcpServers": {
    "eulerian-marketing-platform": {
      "command": "python",
      "args": ["-m", "eulerian_marketing_platform.server"],
      "env": {
        "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp",
        "EMP_API_TOKEN": "your_authentication_token_here"
      }
    }
  }
}

3. Gemini CLIを起動する：

gemini

4. 接続を確認する：
   • /mcp コマンドを使用して接続されているサーバーを表示する
   • Geminiに「What tools are available from the Eulerian Marketing Platform?」と尋ねる

プラットフォーム固有の注意事項

Windows：

• 設定ファイルの場所：%USERPROFILE%\.gemini\settings.json
• ディレクトリを作成する：mkdir %USERPROFILE%\.gemini

Linux/macOS：

• 標準の場所：~/.gemini/settings.json

3. Codex CLI

Codex CLIは、~/.codex/config.toml で構成されたMCPサーバーをサポートしています。この設定は、CLIとCodex IDE拡張機能（VS Code）で共有されます。

事前準備

• Node.js 18以上とnpm
• Codex CLIのインストール：npm install -g @openai/codex
• Python 3.10以上でこのパッケージをインストールする (pip install eulerian-marketing-platform)
• ChatGPT Plus、Pro、Team、Edu、またはEnterpriseのサブスクリプション（またはOpenAI APIキー）

オプションA：codex mcp add コマンドを使用する（最も簡単）

以下のコマンドを実行して、オイラリアンMCPサーバーを登録します。

codex mcp add eulerian-marketing-platform \
  --env EMP_API_ENDPOINT=https://your-eulerian-instance.com/mcp \
  --env EMP_API_TOKEN=your_authentication_token_here \
  -- python -m eulerian_marketing_platform.server

これで完了です。Codexが自動的に ~/.codex/config.toml を更新します。

オプションB：config.toml を手動で編集する

~/.codex/config.toml を開いて（または作成して）、以下の内容を追加します。

[mcp_servers.eulerian-marketing-platform]
command = "python"
args = ["-m", "eulerian_marketing_platform.server"]
tool_timeout_sec = 300

[mcp_servers.eulerian-marketing-platform.env]
EMP_API_ENDPOINT = "https://your-eulerian-instance.com/mcp"
EMP_API_TOKEN = "your_authentication_token_here"

注意：セクション名は 必ず mcp_servers（アンダースコア付き）を使用する必要があります。mcp-servers や他のバリエーションを使用すると、エラーなく失敗します。

オプションC：プロジェクトスコープの設定

MCPサーバーを特定のプロジェクトに限定するには、そのプロジェクトのルートに .codex/config.toml ファイルを作成し、上記と同じ内容を記述します。プロジェクトはCodexによって信頼されている必要があります。

接続を確認する

1. ターミナルでCodexを起動する：

   codex
   

2. インタラクティブTUIで /mcp と入力して、接続されているすべてのMCPサーバーを表示する。
3. eulerian-marketing-platform がリストに表示され、利用可能なツールが表示されることを確認する。
4. 以下の質問を試す：

   What Eulerian Marketing Platform tools do you have access to?
   

サーバーの管理

# 構成されているすべてのMCPサーバーをリストする
codex mcp

# サーバーを削除する
codex mcp remove eulerian-marketing-platform

トラブルシューティング（Codex CLI）

• /mcp にサーバーが表示されない：~/.codex/config.toml に [mcp_servers.eulerian-marketing-platform] セクションが存在し、TOML構文が有効であることを確認してください。
• タイムアウトエラー：config.toml の tool_timeout_sec を増やしてください（デフォルトは60秒）。オイラリアンのクエリは時間がかかることがあるため、300 を推奨します。
• 認証エラー：EMP_API_ENDPOINT と EMP_API_TOKEN が正しいことを再確認してください。
• Pythonが見つからない：python コマンドがPython 3.10以上を指すことを確認してください。必要に応じて python3 を使用することができます。

  command = "python3"
  

• パッケージが見つからない：Codexが呼び出すPython環境に eulerian-marketing-platform がインストールされていることを確認してください。python -m eulerian_marketing_platform.server を手動で実行して動作を確認してください。
• ログを確認する：詳細なエラー情報を得るために、プロキシのログを監視します。

  tail -f /tmp/eulerian-mcp-proxy.log
  

4. Claude Code

Claude Codeは、Anthropicのターミナルベースのコーディングエージェントです。claude mcp CLIコマンドまたは ~/.claude.json を編集することで構成されたMCPサーバーをサポートしています。

事前準備

• Node.js 18以上とnpm
• Claude Codeのインストール：npm install -g @anthropic-ai/claude-code
• Python 3.10以上でこのパッケージをインストールする (pip install eulerian-marketing-platform)
• Anthropic APIキーまたはClaudeのサブスクリプション

オプションA：claude mcp add コマンドを使用する（最も簡単）

claude mcp add eulerian-marketing-platform \
  -e EMP_API_ENDPOINT=https://your-eulerian-instance.com/mcp \
  -e EMP_API_TOKEN=your_authentication_token_here \
  -- python -m eulerian_marketing_platform.server

デフォルトでは、これはローカルスコープ（現在のプロジェクトのみ）でサーバーを追加します。すべてのプロジェクトで利用可能にするには、-s user フラグを追加します。

claude mcp add -s user eulerian-marketing-platform \
  -e EMP_API_ENDPOINT=https://your-eulerian-instance.com/mcp \
  -e EMP_API_TOKEN=your_authentication_token_here \
  -- python -m eulerian_marketing_platform.server

オプションB：~/.claude.json を手動で編集する

~/.claude.json を開き、mcpServers キーの下にサーバーを追加します。

{
  "mcpServers": {
    "eulerian-marketing-platform": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "eulerian_marketing_platform.server"],
      "env": {
        "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp",
        "EMP_API_TOKEN": "your_authentication_token_here"
      }
    }
  }
}

接続を確認する

1. Claude Codeを起動する：

   claude
   

2. /mcp と入力して、接続されているすべてのMCPサーバーの状態を表示する。
3. eulerian-marketing-platform が表示され、接続済みと表示されることを確認する。
4. 以下の質問を試す：

   What Eulerian Marketing Platform tools do you have access to?
   

サーバーの管理

# 構成されているすべてのMCPサーバーをリストする
claude mcp list

# 特定のサーバーの詳細を取得する
claude mcp get eulerian-marketing-platform

# サーバーを削除する
claude mcp remove eulerian-marketing-platform

トラブルシューティング（Claude Code）

• /mcp にサーバーが表示されない：claude mcp list を実行して登録されていることを確認してください。~/.claude.json のJSON構文エラーを確認してください。
• Pythonが見つからない：python コマンドがPython 3.10以上を指すことを確認してください。必要に応じて python3 を使用することができます。
• パッケージが見つからない：Claude Codeが呼び出すPython環境に eulerian-marketing-platform がインストールされていることを確認してください。
• デバッグモード：詳細なMCPログを表示してClaude Codeを起動します。

  claude --mcp-debug
  

• ログを確認する：詳細なエラー情報を得るために、プロキシのログを監視します。

  tail -f /tmp/eulerian-mcp-proxy.log
  

5. Cursor

Cursorは、組み込みのMCPサポートを備えたAIパワードのコードエディターです。

事前準備

• Cursorのインストール（cursor.com からダウンロード）
• Python 3.10以上でこのパッケージをインストールする (pip install eulerian-marketing-platform)

設定ファイルの場所

• グローバル：~/.cursor/mcp.json
• プロジェクトスコープ：プロジェクトルートの .cursor/mcp.json

セットアップ手順

1. 設定ファイルを開く（または作成する）：

# グローバル設定
mkdir -p ~/.cursor
nano ~/.cursor/mcp.json

2. MCPサーバーの設定を追加する：

{
  "mcpServers": {
    "eulerian-marketing-platform": {
      "command": "python",
      "args": ["-m", "eulerian_marketing_platform.server"],
      "env": {
        "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp",
        "EMP_API_TOKEN": "your_authentication_token_here"
      }
    }
  }
}

3. Cursorを再起動して新しい設定を読み込む
4. 接続を確認する：
   • Cursorの設定 → Tools & Integrations → MCP Servers を開く
   • eulerian-marketing-platform が表示され、緑色のステータスが表示されることを確認する
   • Copilotペインで Agent mode に切り替える
   • 「What Eulerian Marketing Platform tools do you have access to?」と尋ねる

プラットフォーム固有の注意事項

Windows：

• グローバル設定ファイル：%USERPROFILE%\.cursor\mcp.json
• python がPATHに含まれていない場合は、command フィールドにPython実行ファイルの完全パスを使用してください。

macOS/Linux：

• 標準の場所：~/.cursor/mcp.json

トラブルシューティング（Cursor）

• サーバーが表示されない：~/.cursor/mcp.json に有効なJSONが含まれていることを確認してください。設定を変更した後はCursorを再起動してください。
• ツールが利用できない：Cursorのチャットパネルで Agent mode（Ask modeではない）になっていることを確認してください。
• Pythonが見つからない：python コマンドがPython 3.10以上を指すことを確認してください。必要に応じて python3 または完全パスを使用することができます。
• ログを確認する：プロキシのログを監視します。

  tail -f /tmp/eulerian-mcp-proxy.log
  

6. VS Code / GitHub Copilot

Visual Studio Codeは、GitHub CopilotのAgentモードを通じてMCPサーバーをサポートしています。MCPにはVS Code 1.101以上が必要です。

事前準備

• GitHub Copilot拡張機能を搭載したVS Code 1.101以上
• Python 3.10以上でこのパッケージをインストールする (pip install eulerian-marketing-platform)
• GitHub Copilotのサブスクリプション

設定ファイルの場所

• ワークスペース：プロジェクトルートの .vscode/mcp.json（推奨）
• ユーザー/グローバル：MCP: Open User Configuration コマンドでアクセスできます。

注意：VS Codeは mcp.json 内で "servers" キー（"mcpServers" ではない）を使用します。

セットアップ手順

1. ワークスペースの設定ファイルを作成する：

mkdir -p .vscode
nano .vscode/mcp.json

2. MCPサーバーの設定を追加する：

{
  "servers": {
    "eulerian-marketing-platform": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "eulerian_marketing_platform.server"],
      "env": {
        "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp",
        "EMP_API_TOKEN": "your_authentication_token_here"
      }
    }
  }
}

あるいは、すべてのワークスペースでサーバーをグローバルに利用可能にするには、ユーザー設定（JSON）（Ctrl+Shift+P → Preferences: Open User Settings (JSON)）に設定を追加します。

{
  "mcp": {
    "servers": {
      "eulerian-marketing-platform": {
        "type": "stdio",
        "command": "python",
        "args": ["-m", "eulerian_marketing_platform.server"],
        "env": {
          "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp",
          "EMP_API_TOKEN": "your_authentication_token_here"
        }
      }
    }
  }
}

3. MCPサーバーを起動する：

   • エディターで .vscode/mcp.json ファイルを開く
   • サーバー定義の上に表示される Start ボタンをクリックする
   • または、コマンドパレットを使用します：MCP: List Servers → サーバーを選択 → Start

4. 接続を確認する：

   • GitHub Copilotチャットパネルで Agent mode に切り替える（チャット入力の近くにあるトグル）
   • Copilotペインの Tools ボタン（🔧）をクリックして、利用可能なオイラリアンツールを表示する
   • 「What Eulerian Marketing Platform tools do you have access to?」と尋ねる

シークレットの入力変数を使用する

トークンをハードコーディングするのを避けるために、VS Codeの入力変数を使用することができます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "empToken",
      "description": "Eulerian Marketing Platform API Token",
      "password": true
    }
  ],
  "servers": {
    "eulerian-marketing-platform": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "eulerian_marketing_platform.server"],
      "env": {
        "EMP_API_ENDPOINT": "https://your-eulerian-instance.com/mcp",
        "EMP_API_TOKEN": "${input:empToken}"
      }
    }
  }
}

サーバーが起動すると、VS Codeがトークンの入力を求めます。

トラブルシューティング（VS Code）

• MCPが利用できない：VS Codeが1.101以上であり、GitHub Copilot拡張機能がインストールされて有効になっていることを確認してください。
• ツールが表示されない：MCPツールはAgent modeでのみ動作します。CopilotチャットパネルでAgent modeに切り替えてください。
• Startボタンが表示されない：コードレンズ（Startボタン）は、.vscode フォルダーがワークスペースのルートにある場合にのみ表示されます。
• Pythonが見つからない：python コマンドがPython 3.10以上を指すことを確認してください。必要に応じて python3 または完全パスを使用することができます。
• ログを確認する：プロキシのログを監視します。

  tail -f /tmp/eulerian-mcp-proxy.log
  

💻 使用例

いずれかのクライアントで設定した後、リモートのオイラリアンマーケティングプラットフォームと対話することができます。

ユーザー: "What tools are available from Eulerian?"
→ プロキシが list_remote_tools() を呼び出し、利用可能なすべてのツールを返します。

ユーザー: "Call the update_goal tool"
→ プロキシがリモートサーバーに転送し、ゴール設定を更新します。

ユーザー: "Show me campaign details for CAMP-12345"
→ Claudeが call_eulerian_tool() を使用して特定のキャンペーンを取得します。

ユーザー: "What resources are available?"
→ プロキシが利用可能なすべてのデータソースをリストします。

AIアシスタントは、あなたのリクエストを満たすために適切なプロキシツールを自動的に使用します。

ログの表示

プロキシのアクティビティをリアルタイムで監視します。

# デフォルトのログ場所
tail -f /tmp/eulerian-mcp-proxy.log

# カスタムのログ場所
tail -f /var/log/eulerian-mcp-proxy.log

以下の詳細なログが表示されます。

• リモートサーバーへのリクエスト
• HTTPレスポンスとステータスコード
• ツールの呼び出しと結果
• エラーと警告

🛠️ トラブルシューティング

一般的な問題

"EMP_API_ENDPOINT environment variable is required"

• 解決策：設定で EMP_API_ENDPOINT を設定していることを確認してください。
• 環境変数名にタイプミスがないことを確認してください。

"EMP_API_TOKEN environment variable is required"

• 解決策：設定で EMP_API_TOKEN を設定していることを確認してください。
• トークンが有効で期限切れになっていないことを確認してください。

Claude Desktopにサーバーが表示されない

• 解決策：
  • Claude Desktopを完全に再起動します。
  • 設定ファイルのJSON構文エラーを確認します。
  • 設定内のファイルパスが正しいことを確認します。
  • ログを確認します：
    • macOS: ~/Library/Logs/Claude/mcp-server-*.log
    • Windows: %APPDATA%\Claude\logs\

Gemini CLIにツールが表示されない

• 解決策：
  • /mcp コマンドを使用してサーバーのステータスを確認します。
  • settings.json が有効なJSONであることを確認します。
  • Gemini CLIを再起動します。

デバッグモード

詳細なデバッグを行うには、以下のコマンドを使用します。

# MCPインスペクターで実行する
npx @modelcontextprotocol/inspector uvx eulerian-marketing-platform

# または環境変数を使用する
EMP_API_ENDPOINT=your_endpoint EMP_API_TOKEN=your_token uvx eulerian-marketing-platform

🔨 開発

テストの実行

# 開発用の依存関係をインストールする
pip install -e ".[dev]"

# テストを実行する
pytest

# カバレッジを含めて実行する
pytest --cov=eulerian_marketing_platform

ソースからのビルド

# リポジトリをクローンする
git clone https://github.com/EulerianTechnologies/eulerian-marketing-platform-mcp.git
cd eulerian-marketing-platform-mcp

# 開発モードでインストールする
pip install -e .

# 配布物をビルドする
pip install build
python -m build

# 以下のファイルが作成されます
# dist/eulerian_marketing_platform-0.1.0.tar.gz
# dist/eulerian_marketing_platform-0.1.0-py3-none-any.whl

🤝 コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークする
2. 新しい機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m 'Add amazing feature')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. プルリクエストを作成する

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

🎈 サポート

• 問題報告：https://github.com/EulerianTechnologies/eulerian-marketing-platform-mcp/issues
• ドキュメント：https://github.com/EulerianTechnologies/eulerian-marketing-platform-mcp#readme
• オイラリアンテクノロジーズ：https://www.eulerian.com

MCPレジストリ用のMCPサーバー

mcp-name: io.github.matjmat/eulerian-marketing-platform-mcp

📋 変更履歴

0.2.8

• プロキシの切断問題を修正
• 不要なログを削除

0.2.3

• 通知に関する切断問題を修正

0.2.0

• 完全なプロキシモードに移行
• uvxデプロイの手順を削除
• Mistral統合の手順を削除（複雑すぎるため）

0.1.0 (初期リリース)

• 初期のMCPサーバー実装
• Claude Desktop、Gemini CLIのサポート
• クロスプラットフォーム対応（Windows、Linux、macOS）
• 環境ベースの設定

注意：使用する前に、すべてのプレースホルダーURLとトークンを実際のオイラリアンマーケティングプラットフォームの資格情報に置き換えてください。