Zapmail MCP

MCP办公协作

提供方 dsouzaalan · 包名 zapmail-mcp

办公协作 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor
查看接入方式

Zapmail MCP Server是一个为Zapmail API提供的模型上下文协议服务器,通过自然语言实现域名管理、邮箱操作和数据导出功能,支持与AI助手如Claude的交互。

一句话选型结论

按资料字段整理

Zapmail MCP 属于办公协作类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式支持远程部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 29 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量29暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

邮件管理JavaScript本地部署自然语言处理API集成域名管理数据导出

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx zapmail-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 29 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 29 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zapmail MCP当前 29 stdio · 本地进程 支持远程部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方dsouzaalan上游标注的维护方 dsouzaalan
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时zapmail-mcp · Node.js本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.1 KB
来自项目仓库与上游目录的原文,未做删改

Zapamail MCP服务器

Zapmail API的模型上下文协议(MCP)服务器,提供对域管理、邮箱操作和导出的自然语言访问。该软件包使像Claude这样的人工智能助手能够通过自然语言命令与Zapamail进行交互。

特性

  • 完整的Zapmail API覆盖范围(46多种工具)
  • 自然语言命令处理
  • 从API文档生成动态工具
  • 对Reachinbox、Instantly、Smartlead、Reply.io和CSV的导出支持
  • 带TTL的缓存系统
  • 速率限制和错误处理
  • 多工作空间支持
  • MCP与Claude Desktop和Cursor的集成

先决条件

  • Node.js 18+
  • Zapmail API密钥
  • MCP兼容客户端(克劳德桌面、光标等)
  • 可选:用于增强自然语言处理的OpenAI API密钥

安装

选项1:使用npx(推荐)

无需安装-直接使用npx运行:```bash
npx zapmail-mcp


### 选项2:全局安装

全局安装以实现持久访问:```bash
npm install -g zapmail-mcp

MCP配置

适用于克劳德桌面

创建或更新 claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
窗户: %APPDATA%\Claude\claude_desktop_config.json

使用npx(推荐):```json
{
"mcpServers": {
"zapmail": {
"command": "npx",
"args": ["zapmail-mcp"],
"env": {
"ZAPMAIL_API_KEY": "your-zapmail-api-key"
}
}
}
}


**使用全局安装:**```json
{
"mcpServers": {
"zapmail": {
"command": "zapmail-mcp",
"args": [],
"env": {
"ZAPMAIL_API_KEY": "your-zapmail-api-key"
}
}
}
}

对于光标

添加到光标MCP设置中:

使用npx(推荐):```json
{
"mcpServers": {
"zapmail": {
"command": "npx",
"args": ["zapmail-mcp"],
"env": {
"ZAPMAIL_API_KEY": "your-zapmail-api-key"
}
}
}
}


**使用全局安装:**```json
{
"mcpServers": {
"zapmail": {
"command": "zapmail-mcp",
"args": [],
"env": {
"ZAPMAIL_API_KEY": "your-zapmail-api-key"
}
}
}
}

快速开始

  1. 获取您的Zapmail API密钥:
  • 注册地址: Zapamail
  • 导航到API设置
  • 生成新的API密钥
  1. 配置您的MCP客户端:
  • 选择您喜欢的MCP客户端(Claude Desktop或Cursor)
  • 将上述配置JSON添加到MCP设置中
  • 替换 your-zapmail-api-key 使用您的实际API密钥
  1. 测试连接:
  • 打开您的MCP客户端
  • 尝试使用自然语言命令,如:
  • “列出我的所有Zapamail工作区”
  • “显示我的域名”
  • “检查example.com是否可供购买”

可用工具

核心管理工具

  • set_context -设置工作区和提供程序上下文
  • wallet_balance -获取钱包余额
  • list_workspaces -列出所有工作区
  • list_domains -列出工作区中的域
  • check_domain_availability -检查域可用性
  • purchase_domains -购买域名(钱包优先)
  • create_mailboxes_for_zero_domains -在空域上创建邮箱
  • add_third_party_account -添加第三方导出帐户
  • call_endpoint -调用任何Zapamail端点
  • generate_usernames -生成邮箱用户名
  • generate_name_pairs -生成名称对
  • generate_domains -生成基于AI的领域建议
  • check_domain_availability_batch -批量域可用性检查
  • plan_and_execute -自然语言计划和执行
  • get_server_info -获取服务器信息

系统管理工具

  • get_metrics -获取系统指标和性能数据
  • clear_cache -清除系统缓存
  • health_check -系统健康检查

高级邮箱工具

  • bulk_update_mailboxes -批量更新邮箱
  • search_mailboxes -使用高级筛选器搜索邮箱

导出系统工具

  • get_export_info -获取导出系统信息
  • get_export_scenario -获取导出场景说明
  • validate_export_request -验证导出请求参数
  • export_guidance -获取出口指导和最佳实践

API文档工具

  • get_api_info -获取全面的API端点信息
  • search_api_endpoints -按关键字搜索API端点
  • get_api_scenarios -获取常见的API使用场景
  • get_api_best_practices -获取API最佳实践和建议
  • generate_api_examples -生成API使用示例

动态API工具

具有自动工具生成功能的所有API端点文档

自然语言命令

连接到MCP客户端后,您可以使用自然语言控制Zapmail:

工作区和域管理

  • “列出我的所有工作区”
  • “显示当前工作区中包含'lead'的域”
  • “检查leadconnectlab.com是否可用2年”
  • “如果可能的话,使用钱包购买leadconnectlab.com和outreachprohub.com一年”

邮箱管理

  • “在没有邮箱的域中创建3个邮箱”
  • “为我设置100个邮箱并连接到Instantly.ai”
  • “用新名称更新所有邮箱”

出口业务

  • “将所有邮箱导出到收件箱”
  • “立即将邮箱导出到”
  • “将邮箱导出为CSV”
  • “导出特定邮箱”
  • “从leadconnectio.com域导出邮箱”

第三方集成

  • “连接收件箱帐户”
  • “立即添加凭据”
  • “链接智能铅帐户”
  • “安装程序reply.io集成”

配置

环境变量

变量 描述 默认值 必填
ZAPMAIL_API_KEY 您的Zapmail API密钥 - 是
ZAPMAIL_WORKSPACE_KEY 默认工作区ID - 否
ZAPMAIL_SERVICE_PROVIDER 电子邮件提供商(谷歌/微软) 谷歌 否
ZAPMAIL_LOG_LEVEL 日志记录级别(调试/信息/警告/错误) 信息 否
ZAPMAIL_MAX_RETRIES 最大重试次数 3 否
ZAPMAIL_TIMEOUT_MS 请求超时(毫秒) 30000 否
ZAPMAIL_ENABLE_CACHE 启用响应缓存 true 否
ZAPMAIL_ENABLE_METRICS 启用性能指标 true 否
ZAPMAIL_RATE_LIMIT_DELAY 速率限制延迟(毫秒) 1000 否
OPENAI_API_KEY 用于增强NLP的OpenAI API密钥 - 否

使用示例

域操作

检查域可用性

在克劳德桌面或光标中:```
"Check if example.com is available for 1 year"


#### 购买域名

**在克劳德桌面或光标中:**```
"Buy example.com and test.com for 1 year using wallet if possible"

邮箱管理

在空域上创建邮箱

在克劳德桌面或光标中:```
"Create 5 mailboxes on domains that have zero mailboxes"


#### 批量更新邮箱

**在克劳德桌面或光标中:**```
"Update all mailboxes with new names and details"

出口业务

导出到Reachinbox

在克劳德桌面或光标中:```
"Connect my Reachinbox account and export all mailboxes"


#### 获取出口指导

**在克劳德桌面或光标中:**```
"Help me export 100 mailboxes to Reachinbox"

复杂的工作流程

多步操作

在克劳德桌面或光标中:```
"Buy example.com and test.com, create 5 mailboxes on each, and export to reachinbox"


#### 工作空间管理

**在克劳德桌面或光标中:**```
"Show me all my workspaces and switch to the one with the most domains"

系统监控

健康检查

在克劳德桌面或光标中:```
"Check the health of my Zapmail connection"


#### 获取指标

**在克劳德桌面或光标中:**```
"Show me performance metrics for my Zapmail operations"

故障排除

MCP连接问题

1.未找到MCP服务器

问题:“找不到zapamil-mcp命令”或“找不到此npx-zapamil-mcp”
解决方案:

对于npx用法:```bash

Test npx directly

npx zapmail-mcp --version

If npx fails, try with explicit package version

npx zapmail-mcp@latest --version

Get help information

npx zapmail-mcp --help


**对于全局安装:**```bash
# Install the package globally
npm install -g zapmail-mcp

# Verify installation
zapmail-mcp --version

2.MCP客户端未检测到服务器

问题:Zapamail工具未出现在克劳德桌面/光标中
解决方案:

  • 重新启动MCP客户端(克劳德桌面/光标)
  • 检查MCP配置文件语法
  • 验证配置中的命令路径

3.API关键问题

问题:“ZAPMAIL_API_KEY未配置”
解决方案:

  • 在MCP配置中设置环境变量:```json
    {
    "mcpServers": {
    "zapmail": {
    "command": "npx",
    "args": ["zapmail-mcp"],
    "env": {
    "ZAPMAIL_API_KEY": "your-api-key"
    }
    }
    }
    }

- 或全局设置:```bash
export ZAPMAIL_API_KEY="your-api-key"

4.工作空间上下文问题

问题:从错误的工作区获取数据
解决方案:在MCP配置中设置工作区:```json
{
"env": {
"ZAPMAIL_WORKSPACE_KEY": "your-workspace-id"
}
}


### 性能问题

#### 1.响应时间慢

**问题**:MCP操作耗时过长
**解决方案**:

- 启用缓存: `ZAPMAIL_ENABLE_CACHE="true"`
- 增加速率限制延迟: `ZAPMAIL_RATE_LIMIT_DELAY="2000"`
- 检查您的互联网连接

#### 2.费率限制

**问题**:“请求太多”错误
**解决方案**:增加MCP配置中的速率限制延迟:```json
{
"env": {
"ZAPMAIL_RATE_LIMIT_DELAY": "2000"
}
}

调试模式

启用调试日志记录以进行详细的故障排除:```json
{
"env": {
"ZAPMAIL_LOG_LEVEL": "DEBUG"
}
}


### 健康检查

测试您的MCP连接:
**在克劳德桌面或光标中:**```
"Check the health of my Zapmail connection"

常见MCP配置错误

1.JSON语法无效

问题:MCP客户端无法加载配置
解决方案:使用JSON验证器验证JSON配置

2.错误的命令路径

问题:MCP客户端中“找不到命令”
解决方案:使用完整路径或确保 zapmail-mcp 在你的路径中

3.环境变量未加载

问题:API密钥未传递到MCP服务器
解决方案:使用 env MCP配置中的部分,而不是全局环境变量

MCP入门

步骤1:安装软件包

选项A:使用npx(推荐)
无需安装-只需使用npx:```bash
npx zapmail-mcp


**选项B:全局安装**```bash
npm install -g zapmail-mcp

步骤2:获取您的Zapmail API密钥

  1. 注册地址: Zapamail
  2. 导航到API设置
  3. 生成新的API密钥
  4. 记下您的工作区ID(可选但推荐)

步骤3:配置MCP客户端

选择您偏好的MCP客户端,并按照上述配置步骤进行操作。

步骤4:测试连接

打开MCP客户端,尝试一个简单的命令:

  • “列出我的Zapamail工作区”
  • “显示我的域名”

步骤5:探索高级功能

连接后,您可以:

  • 通过自然语言管理域和邮箱
  • 导出到第三方平台
  • 设置复杂的自动化工作流程
  • 监控性能和健康状况

包裹信息

  • 包名: zapmail-mcp
  • 版本: 0.0.2
  • NPM: zapamail mcp
  • GitHub: dsouzaalan/zapmail mcp
  • 许可证:MIT

命令行选项

MCP服务器支持以下命令行选项:

版本信息```bash

npx zapmail-mcp --version

or

npx zapmail-mcp -v


### 帮助信息```bash
npx zapmail-mcp --help
# or
npx zapmail-mcp -h

支持

有关支持和问题:

  • 检查上面的故障排除部分
  • 查看MCP配置示例
  • 通过健康检查测试你的联系
  • 启用调试日志记录以获取详细的错误信息
  • 访问 GitHub存储库 用于问题和讨论

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用,添加测试
  5. 提交拉取请求

许可证

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


由以下材料制成❤️ Zapamail社区

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Zapmail MCP 怎么安装?

在客户端按下面的安装命令接入:npx zapmail-mcp。对应的包名是 zapmail-mcp。装完在客户端配置里引用同一个包或端点。

Zapmail MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Zapmail MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zapmail MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Zapmail MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Zapmail MCP 能提供哪些能力?

资料显示约 29 个工具;能力标签包括 邮件管理、JavaScript、Claude。具体工具清单以官方文档为准。

Zapmail MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Zapmail MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。