meser10-mcp

Meser10 MCP 服务

将 Meser10 电子邮件和短信平台连接到任意 MCP 客户端（Claude、Cursor 或你自己的 Agent）。

希伯来语文档，包含引导式安装：https://www.meser10.co.il/features/mcp-server/

自 2026 年 9 月 19 日起列入官方 MCP 注册表，名称为 io.github.meser10/meser10-mcp （v1.0.2，MIT）。可独立验证，无需账户：

https://registry.modelcontextprotocol.io/v0/servers?search=meser10

官方注册表中有两个以色列电子邮件/短信营销平台。只有这个平台以开源形式发布，并且可作为软件包安装；另一个是远程端点，没有代码仓库，也没有软件包。

工具根据实时 WSDL 生成。 这里没有人手动编写 61 个工具定义，这意味着该服务自然覆盖所有 API 功能，并且平台推出新操作时，工具也不会过时。

快速开始

export MESER10_API_KEY=...      # issued in the Meser10 UI
export MESER10_USER_ID=...      # your account number - optional, see below
npx @meser10/mcp-server

启动时，MESER10_USER_ID 为可选项。61 个操作中有 17 个仅通过密钥进行身份验证；其余 44 个需要明确提供账号，因此未设置时会显示清晰的错误消息。除非你确定只需要第一组，否则请设置此项。账号是标识符，不是秘密——在 Meser10 界面中可以看到。

Claude Desktop / Claude Code：

{
  "mcpServers": {
    "meser10": {
      "command": "npx",
      "args": ["-y", "@meser10/mcp-server"],
      "env": { "MESER10_API_KEY": "...", "MESER10_USER_ID": "..." }
    }
  }
}

安全模型

服务以只读模式启动。在你选择启用之前，任何会花费资金、向真人发送消息或删除记录的操作都无法使用。

MESER10_MODE	启用内容	工具数
read （默认）	Get* 系列	16
write	联系人、群组、营销活动草稿	+27
send	向真实收件人发送消息，消耗额度	+13
destructive	永久删除	+5

还有两道防护：

• MESER10_MAX_RECIPIENTS（默认值为 100）会拒绝任何发送给超过上限数量地址的单次发送操作。即使模型误解了提示词，也无法向你的整个列表发送邮件。
• 凭据仅注入，不会暴露。 每个工具的架构都会移除 oLogin 和 iUserID，并由服务填入。模型无法看到、猜测或泄露这些凭据。CLoginInfo 确实接受 UserName/Password，但此服务会刻意从不填入它们——仅使用 ApiKey。

关于错误，必须知道的一点

每个操作都会返回 HTTP 200，包括失败情况。成功与否由 CCallResult 中的 Result 字段决定，而不是状态码。此服务会读取 Result，遇到不是 Success 或 PartialSuccess 的值时抛出错误，并附上补救方法：

LoginFailed: bad key - MESER10_API_KEY was rejected. Reissue the key in the Meser10 UI and restart.

PartialSuccess 会作为警告显示，而不会被当作静默成功，因为它表示批次中的某些记录未能成功处理。

设计说明

隐藏旧版变体。 此接口公开了五个 Ex/Ex2 系列（5 项功能共 15 个操作）。全部提供会让模型在近乎相同的工具间做选择，并导致选错。此服务会公开功能最完整的变体；其余变体可通过 MESER10_EXPOSE_LEGACY=true 显示。

名称便于调用者理解。 GetGroupsList 是平台使用的名称。开发者会使用 list_groups。底层操作名称始终包含在说明中，因此不会隐藏任何内容。

匈牙利式前缀转化为类型提示。 saGroups 是字符串数组，eLang 是枚举，iUserID 是整数。生成器利用这些信息生成更好的架构和便于理解的标题。

故障排除

几分钟前还能用的密钥现在出现 LoginFailed。 平台会在多次认证失败后封锁调用 IP， 封锁时间很长——超过三个半小时。平台显示的错误是 Incorrect user name or password，这与密钥错误无法区分，因此重新签发密钥并重试的做法只会让情况更糟：新密钥也会被封锁，因为被封锁的不是密钥。

如果发生这种情况：停止调用，等待，不要在认证外套上重试循环。切勿自动重试认证失败——重试正是导致封锁的原因；如果是在共享服务器上，这会让所有从同一地址发送请求的其他集成也无法使用。

NotEnoughPermissions。 密钥所属的账户与您设置的 MESER10_USER_ID 不同，或者该账户确实存在，但您的密钥无权访问。平台完全无法解析的账户编号会以另一种方式失败，报错为 ApplicationError，因此此消息表示该编号确实存在。

工具返回状态，但没有数据。 已在 1.0.0 中修复。请升级。

PartialSuccess。 批次中有部分内容未成功提交。服务会将其作为警告显示，而不会静默地报告成功；重试整个批次前，请检查缺少哪些记录。

支持

[email protected] · 03-7440020 · 周日至周四，9:00-17:00（以色列时间）。

请注明操作名称和您收到的 Result 值。切勿提供您的 API 密钥；如果密钥已在任何地方泄露，请重新签发。

开发

npm install && npm run build
npm test            # 43 unit tests + 12 end-to-end tests over real MCP stdio

端到端测试套件会运行一个平台本地替身，因此无需凭据，也不会发送任何内容。

状态

已于 2026-09-12 在生产端点进行验证，采用只读模式：仅使用 ApiKey 认证、工具列表，以及通过整个调用链返回实时数据的四项操作。

也已在本地验证：WSDL 解析、架构生成、安全门、信封构建、凭据注入、错误映射、收件人上限，以及通过标准输入/输出进行的 MCP 协议通信。

写入、发送和删除操作均已实现，并通过针对本地替身的测试覆盖；本项目有意从未在真实账户上执行过这些操作。