Eulerian Marketing Platform MCP

🚀 歐拉營銷平臺MCP服務器

歐拉營銷平臺MCP服務器是一個模型上下文協議（MCP）代理服務器，它能夠將AI助手（如Claude Desktop、Gemini CLI等）連接到遠程的歐拉營銷平臺MCP服務器。該代理負責處理身份驗證、請求轉發，併為遠程歐拉實例提供本地MCP接口。

🚀 快速開始

本服務器作為本地MCP客戶端與遠程歐拉營銷平臺服務器之間的透明代理，其工作原理如下：

┌─────────────┐        ┌──────────────────┐        ┌────────────────┐
│   Claude    │ ◄─────►│  本MCP代理  │◄─────► │ 遠程歐拉服務器 │
│   Desktop   │  stdio │  （本地）  │  HTTP  │  MCP服務器  │
└─────────────┘        └──────────────────┘        └────────────────┘

該代理具備以下功能：

• 🔐 處理與遠程歐拉服務器的身份驗證
• 📡 通過HTTP和Bearer令牌轉發MCP請求
• 🛠️ 向AI助手公開遠程工具和資源
• 📝 提供全面的日誌記錄，方便調試
• ⚡ 使用異步HTTP，提升性能

✨ 主要特性

• 🔌 代理架構：通過HTTP將本地MCP客戶端連接到遠程歐拉MCP服務器
• 🔐 安全認證：使用Bearer令牌認證訪問遠程服務器
• 🌐 跨平臺支持：支持Windows、Linux和macOS系統
• 🤖 多AI客戶端支持：與Claude Desktop、Gemini CLI等兼容
• 📝 全面日誌記錄：記錄所有請求和響應，便於調試
• ⚡ 異步HTTP：使用httpx進行非阻塞請求，提升性能
• 🛠️ 工具發現：自動發現並公開遠程工具
• ⏱️ 可配置超時：可調整請求超時時間

📦 安裝指南

快速開始（推薦）

使用pip安裝本MCP服務器是最簡單的方式。

通過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 .

💻 使用示例

基礎用法

配置好任意客戶端後，你可以與遠程歐拉營銷平臺進行交互：

用戶：“歐拉有哪些可用工具？”
→ 代理調用list_remote_tools()並返回所有可用工具

用戶：“調用update_goal工具”
→ 代理將請求轉發到遠程服務器並更新目標設置

用戶：“顯示CAMP - 12345活動的詳細信息”
→ Claude使用call_eulerian_tool()獲取特定活動信息

用戶：“有哪些可用資源？”
→ 代理列出所有可用數據源

AI助手將自動使用合適的代理工具來滿足你的請求。

查看日誌

即時監控代理活動：

# 默認日誌位置
tail -f /tmp/eulerian-mcp-proxy.log

# 自定義日誌位置
tail -f /var/log/eulerian-mcp-proxy.log

你將看到詳細的日誌記錄，包括：

• 對遠程服務器的請求
• HTTP響應和狀態碼
• 工具調用和結果
• 錯誤和警告

📚 詳細文檔

配置

必需環境變量

• 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菜單 → 設置 → 開發者 → 編輯配置
   • 或手動編輯上述位置的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詢問：“你可以訪問哪些歐拉營銷平臺工具？”

特定平臺注意事項

Windows：

• 使用運行對話框（Win + R）並輸入%APPDATA%\Claude，可快速導航到配置目錄
• 若使用本地安裝，確保Python已添加到系統路徑

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詢問：“歐拉營銷平臺有哪些可用工具？”

特定平臺注意事項

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. 嘗試詢問：

你可以訪問哪些歐拉營銷平臺工具？

管理服務器

# 列出所有已配置的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"

• 未找到包：確保eulerian - marketing - platform已安裝在Codex將調用的Python環境中。手動運行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. 嘗試詢問：

你可以訪問哪些歐拉營銷平臺工具？

管理服務器

# 列出所有已配置的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代替。
• 未找到包：確保eulerian - marketing - platform已安裝在Claude Code將調用的Python環境中。
• 調試模式：使用詳細的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設置 → 工具與集成 → MCP服務器
   • 確認eulerian - marketing - platform出現並顯示綠色狀態
   • 在Copilot面板中切換到代理模式
   • 詢問：“你可以訪問哪些歐拉營銷平臺工具？”

特定平臺注意事項

Windows：

• 全局配置文件：%USERPROFILE%\.cursor\mcp.json
• 若python未添加到系統路徑，可在command字段中使用Python可執行文件的完整路徑。

macOS/Linux：

• 標準位置：~/.cursor/mcp.json

故障排除（Cursor）

• 服務器未顯示：驗證~/.cursor/mcp.json是否包含有效的JSON。配置更改後重啟Cursor。
• 工具不可用：確保在Cursor聊天面板中處於代理模式（而非詢問模式）。
• 未找到Python：確保python命令指向Python 3.10+。你可能需要使用python3或完整路徑。
• 查看日誌：監控代理日誌：

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

6. VS Code / GitHub Copilot

Visual Studio Code通過GitHub Copilot的代理模式支持MCP服務器。MCP要求VS Code版本為1.101或更高。

前提條件

• 安裝了VS Code 1.101+並安裝了GitHub Copilot擴展
• 安裝了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文件
   • 點擊服務器定義上方出現的啟動按鈕（代碼透鏡）
   • 或使用命令面板：MCP: List Servers → 選擇服務器 → 啟動
4. 驗證連接：
   • 在GitHub Copilot聊天面板中切換到代理模式（聊天輸入框附近的切換按鈕）
   • 點擊Copilot面板中的工具按鈕（🔧）查看可用的歐拉工具
   • 詢問：“你可以訪問哪些歐拉營銷平臺工具？”

使用輸入變量處理機密信息

為避免硬編碼令牌，可使用VS Code輸入變量：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "empToken",
      "description": "歐拉營銷平臺API令牌",
      "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工具僅在代理模式下可用。在Copilot聊天面板中切換到代理模式。
• 啟動按鈕未顯示：代碼透鏡（啟動按鈕）僅在.vscode文件夾位於工作區根目錄時出現。
• 未找到Python：確保python命令指向Python 3.10+。你可能需要使用python3或完整路徑。
• 查看日誌：監控代理日誌：

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

可用工具

所有由歐拉API支持的API端點都可以通過當前MCP進行查詢。

🔧 技術細節

故障排除

常見問題

• “EMP_API_ENDPOINT環境變量是必需的”
  • 解決方案：確保在配置中設置了EMP_API_ENDPOINT
  • 檢查環境變量名稱是否有拼寫錯誤
• “EMP_API_TOKEN環境變量是必需的”
  • 解決方案：確保在配置中設置了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 Inspector運行
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

📄 許可證

本項目採用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名稱：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和令牌替換為你實際的歐拉營銷平臺憑證。