ClaudeMap

otpkit

MCP 服务器:签发一次性邮箱地址与手机号、盯住收件箱、直接把验证码与验证链接提取好交回来——所有邮箱 provider 与免费 SMS 源都零 API key

MCP 服务器mcp servertestingemailsmsotppythonpip

otpkit 给 MCP 兼容客户端——Claude Code、Claude Desktop、Cursor 或你自己的 agent——一套注册流程测试工具箱:create_temp_email 签发一次性地址(默认 grabmail,另有 catchmail、guerrillamail、maildrop;list_temp_emails 追踪已创建的邮箱),wait_for_email 与 check_email 轮询收件箱并扫描每封邮件里的 OTP 验证码(4-8 位数字)与验证链接,agent 拿到即可直接贴进表单;extract_otp_from_text 能从任意文本里抠出验证码。SMS 分两档:免费公共共享号源(list_free_sms_numbers、read_free_sms、带超时的 wait_for_sms)与可选的 5sim / smspool 付费私有号码(get_sms_providers、buy_temp_number、check_paid_sms,用 FIVESIM_API_KEY / SMSPOOL_API_KEY 环境变量启用)。所有邮箱 provider 与免费 SMS 源均免鉴权;整个服务器是一个 pip 包,用一条 pip 命令从本仓库安装(pip install git+https://github.com/secfathy/otpkit.git;尚未发布到 PyPI),并在 Claude Code 里一条命令注册。工具共 11 个;README 附架构图、使用示例与排障一节(免费号码是对公共站点的抓取,结果为空可能只是该号近期没有新消息)。

它做什么

  • 邮箱与 SMS 共 11 个工具:create_temp_email、check_email、wait_for_email、list_temp_emails、list_free_sms_numbers、read_free_sms、wait_for_sms、get_sms_providers、buy_temp_number、check_paid_sms、extract_otp_from_text
  • 每封来信自动提取 OTP 验证码(4-8 位)与验证链接,agent 可端到端跑完一次注册
  • 四个免 key 邮箱 provider:grabmail(默认,三个域名)、catchmail、guerrillamail(约 1 小时过期)、maildrop
  • SMS 两档:免费公共共享号码,或经 5sim / smspool 加 API key 拿私有号码
  • 从本仓库一条 pip 命令安装(pip install git+https://github.com/secfathy/otpkit.git——尚未发布到 PyPI);Claude Code 注册一条命令;README 附完整的 claude_desktop_config.json / .cursor/mcp.json 配置块

什么时候用

适合让 agent 端到端测试注册、验证或通知流程——在 E2E 测试里走一遍新账号创建、确认你的 OTP 邮件渲染与验证码解析无误、或搭一个在自己服务上注册演示账号的 QA agent。要注册真实个人账号时,请完全避开免费 SMS 档。

如何上手

从本仓库安装(需 Python 3.10+;otpkit 尚未发布到 PyPI):

pip install git+https://github.com/secfathy/otpkit.git

Claude Code 一条命令:

claude mcp add otpkit -- otpkit

Claude Desktop——Developer → Edit Config,在 claude_desktop_config.json 中加入:

{
  "mcpServers": {
    "otpkit": {
      "command": "otpkit"
    }
  }
}

要用付费私有 SMS,请在同一对象的 env 里加 provider key("FIVESIM_API_KEY"、"SMSPOOL_API_KEY")。Cursor 在 .cursor/mcp.json 里用同样结构的 JSON。claude mcp list 可核验;装好后跑 otpkit 验证——服务器在 stdio 启动(Ctrl+C 停止)。

注意事项

这里的隐私分层很关键,README 写得明白:maildrop 收件箱是公开的——任何人都读得到任何 inbox;免费 SMS 源是公共共享号码——README 警告绝不要用于真实账号或敏感服务;grabmail、catchmail、guerrillamail 为私有。免费号码来自对公共站点的抓取,wait_for_sms 结果为空可能只是该号码近期没有新消息(从 list_free_sms_numbers 换一个再试)。guerrillamail 地址约 1 小时过期。付费 SMS 需要你自己的 5sim/smspool 账号与 key。OTP 自动化属双刃工具:项目将其定位为测试用途,使用时同样请守住边界——只用于你自己的服务与一次性流程。安装渠道核实(2026-11-18):项目的 pyproject.toml 声明 otpkit 1.0.0,但该包尚未发布到 PyPI,uvx otpkit 无法解析——请从本仓库用 pip 安装,再以 otpkit 命令注册。MIT 许可。撰稿时 42 星(2026-11-18)。

代码仓库

SecFathy/otpkit

收录日期

地图上的相关资源

  • Blitz Strike

    MCP 服务器

    把渗透测试方法论装进一个 MCP server:BLITZ 摸清攻击面,EAGLE-EYE 追 source-to-sink,STRIKE 对每条发现先实测再上报。

    • mcp-server
    • security
    • pentest
    • methodology
  • Ripwire

    MCP 服务器

    Red Hat 出品的「AI 上下文版 ripgrep」——C++23 零依赖 CLI,同时讲 MCP。

    • mcp
    • code-context
    • cli
    • red-hat
  • Deja Vu

    MCP 服务器

    让 25+ 个编码 agent 共享同一份会话记忆——Claude Code、Codex、Cursor 终于记得同一个项目。

    • mcp
    • memory
    • cross-agent
    • context