BounceLens Email Check

io.github.akshaycu777-uiv1.0.0更新于 Oct 3, 2026

Check emails for typos, disposable domains and dead domains. Runs locally, no API key.

概览

AI 生成的概览

在本地检查电子邮件地址的拼写错误、一次性域名、失效域名、语法问题、角色地址和重复项,无需 API 密钥。

功能
提供两个工具:check_email 检查单个地址,check_emails 一次检查最多 500 个地址,返回带计数的 summary 以及按输入顺序排列的每个地址的结果。每条结果包含 invalid、risky 或 unconfirmed 状态,以及原因、disposable、role、free、duplicate、gateway 标志、did_you_mean 建议、邮件服务商和 MX 信息。可识别域名拼写错误、一次性域名、不存在或无 MX 的域名、语法错误、角色地址、免费服务商,以及 Gmail 点号和加号标签造成的重复。
适用场景
适合在发送或保存地址列表之前使用,例如清理注册信息、剔除无效和一次性地址、修正拼错的域名并去重。更适合在 MCP 客户端内做快速的列表清理,而不是做邮箱级别的验证。
运行要求
作为本地 stdio 进程运行,需要 Node.js 18 或更高版本,可通过 npx 或克隆仓库启动。无需 API 密钥、账号或注册。它会通过 HTTPS 向 Cloudflare 解析器发起 DNS 查询,因此需要网络访问。
安装前请注意
它不会连接收件人的邮件服务器,因此无法确认邮箱是否存在,最好的结果只是 unconfirmed。只有地址的域名部分会发送到 Cloudflare 的 DNS-over-HTTPS 解析器,完整地址保留在本机。结果仅供参考,可能把正常地址标记为 risky。

安装

在 SourceWeft 中

  1. 打开 控制台中的 BounceLens Email Check,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

BounceLens Email Check – MCP server

[smithery badge]

Lets Claude, Cursor and other MCP clients check email addresses before you send to them or save them. It finds:

  • Typos in the domain: [email protected] → did you mean [email protected]?
  • Disposable / throwaway domains (mailinator.com, 10minutemail and ~9,000 more)
  • Dead domains: the domain doesn't exist, has no mail server, or says it accepts no email (null MX)
  • Bad syntax, role addresses (info@, sales@), free providers, and duplicates (Gmail dot and +tag variants count as the same inbox)
  • The mail provider behind the domain (Google, Microsoft, Proofpoint, …)

Runs on your machine. No API key, no account, no sign-up. The only network calls are DNS lookups over HTTPS (Cloudflare 1.1.1.1). It uses the same checks as the free checker at bouncelens.com.

It never connects to the recipient's mail server, so it can't confirm that a mailbox exists. The best result is unconfirmed (format and domain OK). To check a whole CSV in your browser, use bouncelens.com.

Install

Requires Node.js 18 or newer. Also listed on Smithery.

Claude Code

sh
claude mcp add bouncelens -- npx -y github:bouncelens/mcp-email-check

Claude Desktop, Cursor, Windsurf and other clients. Add this to the client's MCP config (claude_desktop_config.json, .cursor/mcp.json, …):

json
{  "mcpServers": {    "bouncelens": {      "command": "npx",      "args": ["-y", "github:bouncelens/mcp-email-check"]    }  }}

From a clone

sh
git clone https://github.com/bouncelens/mcp-email-check.gitcd mcp-email-check && npm install# then use: "command": "node", "args": ["/path/to/mcp-email-check/index.js"]

Tools

ToolInputReturns
check_emailemail (string)One result
check_emailsemails (array, max 500)summary with counts + one result per address, in input order

Each result (real output for a mistyped Outlook address):

json
{  "input": "[email protected]",  "email": "[email protected]",  "status": "risky",  "reasons": ["No MX record; mail would go to the website server", "Looks like a typo of outlook.com"],  "flags": { "disposable": false, "role": false, "free": false, "duplicate": false, "gateway": false },  "did_you_mean": "[email protected]",  "provider": null,  "mx": null}
statusMeaning
invalidWill bounce: bad syntax, domain doesn't exist, no mail server, or null MX
riskyDisposable domain, likely typo, no MX record (mail would go to the web server), or the DNS lookup failed
unconfirmedFormat and domain OK. The mailbox itself isn't checked

Example prompts

  • "Check these sign-ups for fake or mistyped emails: …"
  • "Is [email protected] a real address?"
  • "Clean this list: drop invalid and disposable addresses, fix the typos, remove duplicates."

Privacy

Addresses never leave your machine. Only the domain part is sent to Cloudflare's DNS-over-HTTPS resolver (1.1.1.1) to look up its MX/A records.

Development

sh
npm installnpm test          # offline: DNS answers are faked

lib/engine.js and data/disposable.json are generated from the BounceLens main codebase, so change them there.

More from BounceLens

  • bouncelens.com – free email list checker in your browser (CSV in, clean list out)
  • Craft CMS plugin – blocks fake and mistyped emails in Craft forms

License

MIT. Disposable-domain list: disposable-email-domains (CC0).

来源:README.md,提交 bf6d9ed

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Oct 3, 2026