mailmodo

@mailmodo/mailmodo-mcp

0 Stars 390 次浏览 mailmodo 更新于 2026-08-23

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "mailmodo": {
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.app.mailmodo.com/mcp",
        "--header",
        "mmApiKey:${MAILMODO_API_KEY}"
      ],
      "command": "npx",
      "env": {
        "MAILMODO_API_KEY": "\u003cGET MAILMODO KEY from https://manage.mailmodo.com/app/settings/apikey and insert here\u003e"
      }
    }
  }
}

服务介绍

mailmodo-mcp

这是一个 TypeScript 项目，实现了用于 Mailmodo 与 Claude Desktop 及其他支持 MCP 的客户端集成的消息控制协议 (MCP) 服务器。

前提条件

Node.js（建议 v20 或更高版本）
npm（随 Node.js 一起提供）

安装

通过 Smithery 安装

要通过 Smithery 自动安装适用于 Claude Desktop 的 Mailmodo 集成服务器：

bash
npx -y @smithery/cli install @mailmodo/mailmodo-mcp --client claude

手动安装

克隆仓库：
bash
git clone https://github.com/mailmodo/mailmodo-mcp.git
cd mailmodo-mcp
安装依赖项：
bash
npm install

构建项目

要将 TypeScript 代码编译为 JavaScript，请运行：
bash
npm run build

这将在 dist 目录中创建编译后的 JavaScript 文件。

运行项目

构建完成后，可以使用以下命令运行项目：
bash
node dist/index.js

或者使用 npm 脚本：
bash
npm start

Claude Desktop 配置

从代码本地运行

要在 Claude Desktop 中配置此项目，请在您的 Claude Desktop 设置中添加以下配置：

json
{
"mcpServers": {
"mailmodo": {
"command": "node",
"args": [
"/path/to/your/mailmodo-mcp/dist/index.js"
]
}
}
}

从 Docker 镜像运行

json
{
"mcpServers": {
"mailmodo": {
"command": "docker",
"args": [
"run",
"--platform",
"linux/amd64",
"-i",
"--rm",
"-e",
"MAILMODO_API_KEY",
"avneesh001/mailmodo-mcp"
],
"env": {
"MAILMODO_API_KEY": "<从 https://manage.mailmodo.com/app/settings/apikey 获取 MAILMODO 密钥并插入此处>"
}
}
}
}

通过 npx 运行

json
{
"mcpServers": {
"mailmodo": {
"command": "npx",
"args": [
"-y",
"@mailmodo/mcp"
],
"env": {
"MAILMODO_API_KEY": "<从 https://manage.mailmodo.com/app/settings/apikey 获取 MAILMODO 密钥并插入此处>"
}
}
}
}

通过远程服务器连接

json
{
"mcpServers": {
"mailmodo": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.app.mailmodo.com/mcp",
"--header",
"mmApiKey:${MAILMODO_API_KEY}"
],
"env": {
"MAILMODO_API_KEY": "<从 https://manage.mailmodo.com/app/settings/apikey 获取 MAILMODO 密钥并插入此处>"
}
}
}
}

请确保 args 数组中的文件路径与您的本地项目目录匹配。

开发

要在开发模式下运行项目并自动重新编译：

将 ts-node 和 nodemon 安装为开发依赖项：
bash
npm install --save-dev ts-node nodemon
在 package.json 中添加一个开发脚本：
json
{
"scripts": {
"dev": "nodemon src/index.ts",
"build": "tsc",
"start": "node dist/index.js"
}
}
运行开发服务器：
bash
npm run dev

项目结构

mailmodo-mcp/
├── src/ # TypeScript 源文件
├── dist/ # 编译后的 JavaScript 文件
├── package.json # 项目依赖和脚本
└── tsconfig.json # TypeScript 配置

工具和资源

Mailmodo MCP 服务器提供了多种工具和资源，以方便与 Mailmodo 功能的交互。以下是全面列表：

资源

Mailmodo 模板 (mailmodo://templates)
- 以 JSON 格式返回所有可用电子邮件模板的列表
- MIME 类型：application/json2. Mailmodo 活动 (mailmodo://campaigns)
- 以 JSON 格式返回所有活动的列表
- MIME 类型: application/json
Mailmodo 联系人列表 (mailmodo://contact-lists)
- 以 JSON 格式返回所有联系人列表
- MIME 类型: application/json

工具

用户详情
- 名称: userDetails
- 描述: 获取联系人的所有详细信息
- 参数:
  - email (字符串): 联系人的电子邮件地址
活动报告工具
- 名称: MailmodoCampainReportTool
- 描述: 获取包括打开、点击和提交次数在内的活动报告
- 参数:
  - campaignId (UUID): 活动 ID
  - fromDate (YYYY-MM-DD): 报告开始日期
  - toDate (YYYY-MM-DD): 报告结束日期
当前日期时间
- 名称: currentDateTime
- 描述: 获取当前日期和时间
- 参数: 无
发送事件
- 名称: sendEvent
- 描述: 发送带有电子邮件和事件属性的自定义事件
- 参数:
  - email (字符串): 联系人的电子邮件地址
  - event_name (字符串): 事件名称
  - ts (数字, 可选): 时间戳
  - event_properties (对象, 可选): 额外的事件属性
联系人列表管理
- 将联系人添加到列表
  - 名称: addContactToList
  - 描述: 将单个联系人添加到列表中
  - 参数:
    - email (字符串): 联系人的电子邮件
    - listName (字符串): 列表名称
    - data (对象, 可选): 联系人属性
    - 各种可选字段用于联系人元数据
- 批量添加联系人
  - 名称: addBulkContactToList
  - 描述: 在一次操作中将多个联系人添加到列表中
  - 参数:
    - listName (字符串): 列表名称
    - values (数组): 联系人对象数组
- 从列表中移除联系人
  - 名称: removeContactFromList
  - 描述: 从特定列表中移除一个联系人
  - 参数:
    - email (字符串): 联系人的电子邮件
    - listName (字符串): 列表名称
联系人状态管理
- 取消订阅联系人
  - 名称: unsubscribeContact
  - 描述: 取消订阅或屏蔽一个联系人
  - 参数:
    - email (字符串): 联系人的电子邮件
- 重新订阅联系人
  - 名称: resubscribeContact
  - 描述: 重新订阅一个之前已取消订阅的联系人
  - 参数:
    - email (字符串): 联系人的电子邮件
- 归档联系人
  - 名称: archiveContact
  - 描述: 永久归档一个联系人
  - 参数:
    - email (字符串): 联系人的电子邮件
活动管理
- 发送电子邮件活动
  - 名称: sendEmailToCampaign
  - 描述: 触发带有个性化设置的电子邮件活动
  - 参数:
    - campaignId (字符串): 活动 ID
    - email (字符串): 收件人的电子邮件
    - 各种可选参数用于定制化
- 广播活动
  - 名称: broadcastCampaignToList
  - 描述: 向整个联系人列表触发活动
  - 参数:
    - campaignId (字符串): 活动 ID
    - listId (字符串): 目标列表 ID
    - 可选参数用于活动定制化

许可证

MIT 许可证

查看源码项目主页