使用说明

欧拉营销平台MCP服务器

模型上下文协议（MCP） 代理服务器 它将人工智能助手（Claude Desktop、Gemini CLI等）连接到远程欧拉营销平台MCP服务器。此代理处理身份验证、请求转发，并为您的远程欧拉实例提供本地MCP接口。

运作原理

此服务器充当 透明代理 在本地MCP客户端和远程欧拉营销平台服务器之间：

┌─────────────┐        ┌──────────────────┐        ┌────────────────┐
│   Claude    │ ◄─────►│  This MCP Proxy  │◄─────► │ Remote Eulerian│
│   Desktop   │  stdio │  (Local)         │  HTTP  │  MCP Server    │
└─────────────┘        └──────────────────┘        └────────────────┘

代理人：

🔐 处理与远程欧拉服务器的身份验证
📡 使用承载令牌通过HTTP转发MCP请求
🛠️ 将远程工具和资源暴露给AI助手
📝 为调试提供全面的日志记录
⚡ 使用异步HTTP以获得更好的性能

警告

鉴于协议、实现和新功能的快速发展，MCP可能与您的工具套件兼容，也可能不兼容。请填写一个问题，以便我们检查。

特性

🔌 代理架构：通过HTTP将本地MCP客户端连接到远程欧拉MCP服务器
🔐 安全认证：使用承载令牌身份验证进行远程服务器访问
🌐 与跨平台支持：适用于Windows、Linux和macOS
🤖 多个AI客户端：与Claude Desktop和Gemini CLI兼容
📝 综合录井：记录所有调试请求/响应
⚡ 异步HTTP：使用httpx进行非阻塞请求以获得更好的性能
🛠️ 工具发现：自动发现并公开远程工具
⏱️ 可配置超时：可调请求超时

先决条件

Python 3.10或更高版本- 安装Python
访问远程欧拉营销平台MCP服务器（HTTP端点）
远程服务器的有效身份验证令牌
以下AI客户端之一：
- 克劳德桌面（Windows、macOS、Linux）
- Gemini CLI
- Codex命令行界面（macOS、Linux）
- 克劳德代码（macOS、Linux）
- 光标（Windows、macOS、Linux）
- VS代码与GitHub Copilot（Windows、macOS、Linux）

可用工具

支持的所有API终结点欧洲API 可以通过当前的MCP进行查询。

安装

快速入门（推荐）

使用此MCP服务器的最简单方法是 pip.

确保 pip 已安装： python -m pip install --upgrade 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 项目中的文件：

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

# Optional
EMP_LOG_FILE=/var/log/eulerian-mcp-proxy.log
EMP_TIMEOUT=600

客户设置说明

1.克劳德桌面

有两种安装方法可供选择。DXT扩展是最简单的，不需要终端。

选项A：一键式DXT扩展（推荐）

桌面扩展（DXT）只需双击，即可在Claude Desktop中安装MCP服务器，而无需编辑JSON配置文件。

需求：安装了包的Python 3.10+：

pip install eulerian-marketing-platform

安装步骤:

下载最新 .dxt 文件来自发布页面
双击 .dxt file--Claude Desktop打开安装对话框
输入您的 API端点 和 API代币 当系统提示时
点击安装 --服务器立即准备就绪

就是这样。不 pip install，无需编辑配置文件，无需重新启动。

更新：下载新 .dxt 然后再次双击它。

选项B：手动JSON配置

Claude Desktop通过stdio传输支持本地MCP服务器。

配置文件位置

视窗: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

设置步骤

打开克劳德桌面
访问配置:
- 点击 Claude menu → Settings → Developer → Edit Config
- 或者在上面的位置手动编辑JSON文件
添加服务器配置:

{
  "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"
      }
    }
  }
}

重新启动克劳德桌面
验证连接:
- 寻找锤子/工具图标(🔨) 在右下角
- 点击查看可用的欧拉工具
- 问克劳德：“你可以使用哪些欧拉营销平台工具？”

平台特定注意事项

视窗:

使用“运行”对话框(Win + R)并进入 %APPDATA%\Claude 快速导航到config目录
如果使用本地安装，请确保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

设置步骤

创建或编辑设置文件:

# Create the directory if it doesn't exist
mkdir -p ~/.gemini

# Edit the settings file
nano ~/.gemini/settings.json

添加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"
      }
    }
  }
}

启动Gemini CLI:

gemini

验证连接:
- 使用 /mcp 查看已连接服务器的命令
- 询问Gemini：“欧拉营销平台提供了哪些工具？”

平台特定注意事项

视窗:

设置文件位置： %USERPROFILE%\.gemini\settings.json
创建目录： mkdir %USERPROFILE%\.gemini

Linux/macOS:

标准位置： ~/.gemini/settings.json

3.Codex CLI

Codex CLI支持在中配置的MCP服务器 ~/.codex/config.toml配置在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/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：
```
codex
```
类型 /mcp 在交互式TUI中查看所有连接的MCP服务器。
确认 eulerian-marketing-platform 显示在列表中及其可用工具。

试着问：

What Eulerian Marketing Platform tools do you have access to?

管理服务器

# List all configured MCP servers
codex mcp

# Remove the server
codex mcp remove eulerian-marketing-platform

故障排除（Codex CLI）

服务器未出现在 /mcp：验证 [mcp_servers.eulerian-marketing-platform] 部分存在于 ~/.codex/config.toml 并且TOML语法是有效的。
超时错误：增加 tool_timeout_sec 在config.toml中（默认值为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是Anthropic基于终端的编码代理。它支持通过配置的MCP服务器 claude mcp CLI命令或通过编辑 ~/.claude.json.

先决条件

Node.js 18+和npm
已安装克劳德代码： 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"
      }
    }
  }
}

验证连接

启动克劳德代码：
```
claude
```
类型 /mcp 查看所有连接的MCP服务器的状态。
确认 eulerian-marketing-platform 显示为 连接的.

试着问：

What Eulerian Marketing Platform tools do you have access to?

管理服务器

# List all configured MCP servers
claude mcp list

# Get details for a specific server
claude mcp get eulerian-marketing-platform

# Remove the server
claude mcp remove eulerian-marketing-platform

故障排除（克劳德代码）

服务器未出现在 /mcp：运行 claude mcp list 以确认其已注册。检查 ~/.claude.json JSON语法错误。
未找到Python：确保 python 命令解析为Python 3.10+。您可能需要使用 python3 相反。
未找到包：确保 eulerian-marketing-platform 安装在Claude Code将调用的Python环境中。
调试模式：启动带有详细MCP日志记录的Claude代码：
```
claude --mcp-debug
```
检查日志：监视代理日志以获取详细的错误信息：
```
tail -f /tmp/eulerian-mcp-proxy.log
```

5.光标

Cursor是一个内置MCP支持的AI驱动代码编辑器。

先决条件

已安装游标（从下载 cursor.com)
安装了此软件包的Python 3.10+(pip install eulerian-marketing-platform)

配置文件位置

全球: ~/.cursor/mcp.json
项目范围: .cursor/mcp.json 在项目根目录中

设置步骤

打开（或创建）配置文件:

# Global configuration
mkdir -p ~/.cursor
nano ~/.cursor/mcp.json

添加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"
      }
    }
  }
}

重新启动游标 加载新配置。
验证连接:
- 打开光标设置→ 工具和集成 → MCP服务器
- 确认 eulerian-marketing-platform 出现并显示绿色状态
- 切换到 代理模式 在“副本”窗格中
- 问：“您可以使用哪些欧拉营销平台工具？”

平台特定注意事项

视窗:

全局配置文件： %USERPROFILE%\.cursor\mcp.json
如果 python 如果不在PATH中，请使用Python可执行文件的完整路径 command 现场。

macOS/Linux:

标准位置： ~/.cursor/mcp.json

故障排除（光标）

服务器未出现：验证 ~/.cursor/mcp.json 包含有效的JSON。更改任何配置后重新启动Cursor。
工具不可用：确保你在 代理模式 光标聊天面板中的（非询问模式）。
未找到Python：确保 python 命令解析为Python 3.10+。您可能需要使用 python3 或者一条完整的路径。
检查日志：监视代理日志：
```
tail -f /tmp/eulerian-mcp-proxy.log
```

6.VS代码/GitHub副本

Visual Studio Code通过GitHub Copilot的代理模式支持MCP服务器。MCP需要VS代码1.101或更高版本。

先决条件

VS代码1.101+，带有GitHub Copilot扩展
安装了此软件包的Python 3.10+(pip install eulerian-marketing-platform)
GitHub Copilot 订阅

配置文件位置

工作区: .vscode/mcp.json 在项目根目录中（推荐）
用户/全局：可通过命令访问 MCP: Open User Configuration

注： VS代码使用 "servers" 密钥（不是 "mcpServers")里面 mcp.json.

设置步骤

创建工作区配置文件:

mkdir -p .vscode
nano .vscode/mcp.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"
      }
    }
  }
}

或者，要使服务器在所有工作区中全局可用，请将配置添加到您的 用户设置（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"
        }
      }
    }
  }
}

启动MCP服务器:
- 打开 .vscode/mcp.json 编辑器中的文件
- 点击开始出现在服务器定义上方的按钮（代码镜头）
- 或者使用命令选项板： MCP: List Servers → 选择服务器→ Start
验证连接:
- 切换到 代理模式 在GitHub Copilot聊天面板中（位于聊天输入附近的切换）
- 点击工具按钮(🔧) 在“副本”窗格中查看可用的欧拉工具
- 问：“您可以使用哪些欧拉营销平台工具？”

使用输入变量作为机密

为了避免硬编码您的令牌，您可以使用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代码）

MCP不可用：确保您正在运行VS Code 1.101或更高版本 并安装和启用GitHub Copilot扩展。
工具未出现：MCP工具仅适用于 代理模式。在副驾驶聊天面板中切换到代理模式。
启动按钮未显示：编码镜头（开始按钮）仅在以下情况下出现 .vscode 文件夹位于工作区的根目录。
未找到Python：确保 python 命令解析为Python 3.10+。您可能需要使用 python3 或者一条完整的路径。
检查日志：监视代理日志：
```
tail -f /tmp/eulerian-mcp-proxy.log
```

使用示例

一旦配置了任何客户端，您就可以与远程欧拉营销平台进行交互：

User: "What tools are available from Eulerian?"
→ Proxy calls list_remote_tools() and returns all available tools

User: "Call the update_goal tool"
→ Proxy forwards to remote server and update goal settings

User: "Show me campaign details for CAMP-12345"
→ Claude uses call_eulerian_tool() to fetch specific campaign

User: "What resources are available?"
→ Proxy lists all available data sources

AI助手将自动使用适当的代理工具来满足您的请求。

查看日志

实时监控代理活动：

# Default log location
tail -f /tmp/eulerian-mcp-proxy.log

# Custom log location
tail -f /var/log/eulerian-mcp-proxy.log

您将看到以下内容的详细日志记录：

对远程服务器的请求
HTTP响应和状态代码
工具调用和结果
错误和警告

故障排除

常见问题

“需要EMP_API_ENDPOINT环境变量”

解决方案：确保您已设置 EMP_API_ENDPOINT 在您的配置中
检查环境变量名称中是否没有拼写错误

“需要EMP_API_TOKEN环境变量”

解决方案：确保您已设置 EMP_API_TOKEN 在您的配置中
验证您的令牌是否有效且未过期

服务器未出现在Claude Desktop中

解决方案:
- 完全重新启动克劳德桌面
- 检查配置文件是否存在JSON语法错误
- 验证配置中的文件路径是否正确
- 查看日志：
  - macOS： ~/Library/Logs/Claude/mcp-server-*.log
  - 窗户： %APPDATA%\Claude\logs\

Gemini CLI中未显示工具

解决方案:
- 使用 /mcp 检查服务器状态的命令
- 验证settings.json是有效的json
- 重新启动Gemini CLI

调试模式

详细调试：

# Run with MCP Inspector
npx @modelcontextprotocol/inspector uvx eulerian-marketing-platform

# Or with environment variables
EMP_API_ENDPOINT=your_endpoint EMP_API_TOKEN=your_token uvx eulerian-marketing-platform

发展

运行测试

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run with coverage
pytest --cov=eulerian_marketing_platform

从源头构建

# Clone the repository
git clone https://github.com/EulerianTechnologies/eulerian-marketing-platform-mcp.git
cd eulerian-marketing-platform-mcp

# Install in development mode
pip install -e .

# Build Python distribution (wheel + tarball)
pip install build
python -m build

# Build DXT extension for Claude Desktop
npx @anthropic-ai/dxt pack .
# → eulerian-marketing-platform-mcp.dxt

贡献

欢迎投稿！请随时提交拉取请求。

分叉存储库
创建功能分支(git checkout -b feature/amazing-feature)
提交您的更改(git commit -m 'Add amazing feature')
推到分支(git push origin feature/amazing-feature)
打开拉取请求

许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

支持

问题: 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/欧拉营销平台-mcp

更新日志

0.2.9

添加 manifest.json 用于Claude Desktop DXT扩展支持
DXT软件包：一键安装，带凭据提示，无需JSON配置编辑

0.2.8

修复了代理断开连接的问题
删除不必要的日志记录

0.2.3

修复了通知的断开连接问题

0.2.0

移动到完全代理模式
删除uvx部署说明
删除Mistral集成的说明（太复杂）

0.1.0（初始版本）

MCP服务器的初始实施
支持Claude Desktop、Gemini CLI
跨平台支持（Windows、Linux、macOS）
基于环境的配置

使用说明

欧拉营销平台MCP服务器

运作原理

警告

特性

先决条件

可用工具

安装

快速入门（推荐）

通过 pip 安装

替代方案：从源代码安装

配置

所需的环境变量

可选环境变量

示例 .env 文件

客户设置说明

1.克劳德桌面

选项A：一键式DXT扩展（推荐）

选项B：手动JSON配置

配置文件位置

设置步骤

平台特定注意事项

2.Gemini CLI

先决条件

配置文件位置

设置步骤

平台特定注意事项

3.Codex CLI

先决条件

选项A：使用 codex mcp add 命令（最简单）

选项B：编辑 config.toml 手动地

选项C：项目范围配置

验证连接

管理服务器

故障排除（Codex CLI）

4.克劳德密码

先决条件

选项A：使用 claude mcp add 命令（最简单）

选项B：编辑 ~/.claude.json 手动地

验证连接

管理服务器

故障排除（克劳德代码）

5.光标

先决条件

配置文件位置

设置步骤

平台特定注意事项

故障排除（光标）

6.VS代码/GitHub副本

先决条件

配置文件位置

设置步骤

使用输入变量作为机密

故障排除（VS代码）

使用示例

查看日志

故障排除

常见问题

“需要EMP_API_ENDPOINT环境变量”

“需要EMP_API_TOKEN环境变量”

服务器未出现在Claude Desktop中

Gemini CLI中未显示工具

调试模式

发展

运行测试

从源头构建

贡献

许可证

支持

MCP注册表的MCP服务器

更新日志

0.2.9

0.2.8

0.2.3

0.2.0

0.1.0（初始版本）

相关 MCP

ChatGPT交互工具

MCP代理服务器

Loki日志查询服务

示例 `.env` 文件

选项A：使用 `codex mcp add` 命令（最简单）

选项B：编辑 `config.toml` 手动地

选项A：使用 `claude mcp add` 命令（最简单）

选项B：编辑 `~/.claude.json` 手动地