eulerian-marketing-platform-mcp

Name: eulerian-marketing-platform-mcp
Author: matjmat

本地服务

github.com/EulerianTechnologies数据与分析120 周前更新

代码仓库

关于 eulerian-marketing-platform-mcp

面向 Eulerian Marketing Platform 用户的 Python 代理，用于连接本地 AI 助手与远程 Eulerian MCP 服务。它负责令牌认证和请求转发，并向客户端开放远程工具与资源。

主要功能

01代理连接远程服务
02Bearer 令牌认证
03自动发现远程工具
04可配置请求超时
05记录请求与响应

适用场景

01将本地助手连接到 Eulerian
02访问远程 Eulerian 工具与资源
03通过代理日志排查请求问题

MCP 相关

为远程 Eulerian MCP 服务提供本地 MCP 接口，通过 HTTP 转发请求，并向 MCP 客户端开放其工具和资源。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "matjmat-eulerian-marketing-platform": {
      "command": "uvx",
      "args": [
        "eulerian-marketing-platform"
      ],
      "env": {
        "EMP_API_TOKEN": "<EMP_API_TOKEN>",
        "EMP_API_ENDPOINT": "<EMP_API_ENDPOINT>"
      }
    }
  }
}

启动命令uvx eulerian-marketing-platform

需要配置的环境变量

EMP_API_TOKEN密钥Your Eulerian Marketing Platform API key

EMP_API_ENDPOINTYour Eulerian Marketing Platform MCP Endpoint

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypieulerian-marketing-platform0.2.9stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Eulerian Marketing Platform MCP 服务

一个 Model Context Protocol（MCP）代理服务，用于连接 AI 助手（Claude Desktop、Gemini CLI 等）与远程 Eulerian Marketing Platform MCP 服务。此代理负责身份验证、请求转发，并为远程 Eulerian 实例提供本地 MCP 接口。

工作原理

此服务充当本地 MCP 客户端与远程 Eulerian Marketing Platform 服务之间的透明代理：

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

此代理：

🔐 处理与远程 Eulerian 服务的身份验证
📡 通过 HTTP 和 Bearer 令牌转发 MCP 请求
🛠️ 向 AI 助手公开远程工具和资源
📝 提供全面的日志记录，便于调试
⚡ 使用异步 HTTP 提升性能

警告

鉴于协议、实现和新功能快速演进，MCP 可能与您的工具套件兼容，也可能不兼容。请提交 issue，以便我们检查。

功能

🔌 代理架构：通过 HTTP 将本地 MCP 客户端连接到远程 Eulerian MCP 服务
🔐 安全身份验证：使用 Bearer 令牌对远程服务进行身份验证
🌐 跨平台支持：支持 Windows、Linux 和 macOS
🤖 多种 AI 客户端：兼容 Claude Desktop 和 Gemini CLI
📝 全面的日志记录：记录所有请求和响应，便于调试
⚡ 异步 HTTP：使用 httpx 发送非阻塞请求，提升性能
🛠️ 工具发现：自动发现并公开远程工具
⏱️ 可配置的超时时间：可调整请求超时时间

前提条件

Python 3.10 或更高版本 - 安装 Python
可访问远程 Eulerian Marketing Platform 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）

可用工具

可通过当前 MCP 查询 Eulerian API 支持的所有 API 端点。

安装

快速开始（推荐）

使用此 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：远程 Eulerian Marketing Platform MCP 服务的 URL（HTTP 端点）
- 示例：https://dem.api.eulerian.com/mcp
EMP_API_TOKEN：远程服务的身份验证令牌，即关联到您的 Eulerian 账户的令牌。

可选的环境变量

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. Claude Desktop

提供两种安装方式。DXT 扩展是最简单的方式——无需使用终端。

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

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

要求：安装了该软件包的 Python 3.10+：

pip install eulerian-marketing-platform

安装步骤：

从发布页面下载最新的 .dxt 文件
双击 .dxt 文件 — Claude Desktop 将打开安装对话框
根据提示输入你的API 端点和 API Token
点击安装 — 服务即可立即使用

就是这么简单。无需运行 pip install，无需编辑配置文件，也无需重启。

更新时：下载新的 .dxt 文件，再次双击即可。

选项 B：手动配置 JSON

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

设置步骤

打开 Claude Desktop
访问配置：
- 点击 Claude 菜单 → 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"
      }
    }
  }
}

重启 Claude Desktop
验证连接：
- 查看右下角是否有锤子/工具图标（🔨）
- 点击图标，查看可用的 Eulerian 工具
- 询问 Claude：“你可以使用哪些 Eulerian Marketing Platform 工具？”

平台特定说明

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

设置步骤

创建或编辑设置文件：

# 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：“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` 命令（最简单）

运行以下命令以注册 Eulerian 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 标记为可信。

验证连接

在终端中启动 Codex：
```
codex
```
在交互式 TUI 中输入 /mcp，查看所有已连接的 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 中未显示服务：确认 ~/.codex/config.toml 中存在 [mcp_servers.eulerian-marketing-platform] 部分，并且 TOML 语法有效。
超时错误：在 config.toml 中增大 tool_timeout_sec（默认值为 60 秒）。Eulerian 查询可能需要更长时间，因此建议设为 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 推出的基于终端的编码 Agent。它支持通过 claude mcp CLI 命令配置 MCP 服务，也支持编辑 ~/.claude.json 进行配置。

前置条件

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

验证连接

启动 Claude Code：
```
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

故障排除（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

设置步骤

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

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

重启 Cursor，加载新配置。
验证连接：
- 打开 Cursor 设置 → 工具与集成 → MCP 服务
- 确认显示了 eulerian-marketing-platform，且状态为绿色
- 在 Copilot 窗格中切换到 Agent 模式
- 询问：“你可以使用哪些 Eulerian Marketing Platform 工具？”

平台特定说明

Windows：

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

macOS/Linux：

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

故障排查（Cursor）

未显示服务：确认 ~/.cursor/mcp.json 包含有效的 JSON。更改配置后，请重启 Cursor。
工具不可用：确保在 Cursor 聊天面板中处于 Agent 模式（而非 Ask 模式）。
找不到 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 或更高。

先决条件

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"）。

设置步骤

创建工作区配置文件：

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 文件
- 点击服务定义上方显示的 Start 按钮（代码镜头）
- 或使用命令面板：MCP: List Servers → 选择服务 → Start
验证连接：
- 在 GitHub Copilot Chat 面板中切换到 Agent 模式（切换按钮位于聊天输入框附近）
- 点击 Copilot 窗格中的 Tools 按钮（🔧），查看可用的 Eulerian 工具
- 询问：“你可以使用哪些 Eulerian Marketing Platform 工具？”

使用输入变量存储机密

为避免将令牌硬编码，可以使用 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 模式下可用。在 Copilot Chat 面板中切换到 Agent 模式。
未显示 Start 按钮：只有当 .vscode 文件夹位于工作区根目录时，才会显示代码镜头（Start 按钮）。
找不到 Python：确保 python 命令指向 Python 3.10 或更高版本。你可能需要使用 python3 或完整路径。
查看日志：监控代理日志：
```
tail -f /tmp/eulerian-mcp-proxy.log
```

使用示例

在任意客户端完成配置后，你便可以与远程 Eulerian Marketing Platform 交互：

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 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

调试模式

如需详细调试：

# 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

贡献

欢迎贡献！欢迎提交 Pull Request。

Fork 此仓库
创建功能分支（git checkout -b feature/amazing-feature）
提交更改（git commit -m 'Add amazing feature'）
推送到该分支（git push origin feature/amazing-feature）
创建 Pull Request

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

支持

问题反馈：https://github.com/EulerianTechnologies/eulerian-marketing-platform-mcp/issues
文档：https://github.com/EulerianTechnologies/eulerian-marketing-platform-mcp#readme
Eulerian Technologies：https://www.eulerian.com

MCP Registry 的 MCP 服务

mcp-name: io.github.matjmat/eulerian-marketing-platform-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）
基于环境变量的配置

注意：使用前，请将所有占位 URL 和令牌替换为你实际的 Eulerian Marketing Platform 凭据。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

eulerian-marketing-platform-mcp

关于 eulerian-marketing-platform-mcp

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Eulerian Marketing Platform MCP 服务

工作原理

警告

功能

前提条件

可用工具

安装

快速开始（推荐）

通过 pip 安装

备用方式：从源代码安装

配置

必需的环境变量

可选的环境变量

.env 文件示例

各客户端的设置说明

1. Claude Desktop

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

选项 B：手动配置 JSON

配置文件位置

设置步骤

平台特定说明

2. Gemini CLI

前提条件

配置文件位置

设置步骤

平台特定说明

3. Codex CLI

前提条件

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

选项 B：手动编辑 config.toml

选项 C：项目级配置

验证连接

管理服务

故障排除（Codex CLI）

4. Claude Code

前置条件

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

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

验证连接

管理服务

故障排除（Claude Code）

5. Cursor

前置条件

配置文件位置

设置步骤

平台特定说明

故障排查（Cursor）

6. VS Code / GitHub Copilot

先决条件

配置文件位置

设置步骤

使用输入变量存储机密

故障排查（VS Code）

使用示例

查看日志

故障排查

常见问题

“EMP_API_ENDPOINT environment variable is required”

“EMP_API_TOKEN environment variable is required”

Claude Desktop 中未显示服务

Gemini CLI 中未显示工具

调试模式

开发

运行测试

从源代码构建

贡献

许可证

支持

MCP Registry 的 MCP 服务

更新日志

0.2.9

0.2.8

`.env` 文件示例

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

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

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

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