临时邮箱服务

提供一次性临时邮箱服务,支持API、CLI、MCP服务器和Web应用,适用于验证码接收和邮件管理。

  • by blipemail
  • Kotlin
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 blipemail/blip

使用说明

哔哔声

即时一次性电子邮件收件箱。API、CLI、MCP服务器和web应用程序。

Useblip.mail | 文档 | API 参考

特性

  • 带有随机或自定义蛞蝓的一次性电子邮件地址
  • 通过SSE实时发送电子邮件
  • OTP和验证链接提取
  • 带有HMAC-SHA256签名和传递日志的Webhooks
  • 用于终端工作流的CLI
  • 用于AI代理的MCP服务器
  • 多域支持

建筑

blip/
  server/core/      Kotlin/Ktor API server (AGPL-3.0)
  cli/              Kotlin/Clikt CLI
  mcp-server/       TypeScript MCP server (npm: @useblip/email)
  shared-models/    Shared Kotlin data models

快速启动

管理(使用blip.email)

无需设置。在以下位置创建收件箱 学徒制 或通过API:

# Get a session token
curl -X POST https://api.useblip.email/v1/sessions

# Create an inbox
curl -X POST https://api.useblip.email/v1/inboxes \
  -H "Authorization: Bearer <token>"

命令行界面

brew install bmcreations/tap/blip

blip create
blip inbox --watch

自托管

先决条件:JDK 21+, libSQL(sqld)

git clone https://github.com/blipemail/blip.git
cd blip
./gradlew :server:core:buildFatJar

# Start libSQL
sqld --http-listen-addr 127.0.0.1:8081 &

# Run the server
TURSO_URL=http://localhost:8081 WORKER_SECRET=dev-secret \
  java -jar server/core/build/libs/*-all.jar

或者使用Docker:

docker build -t blip .
docker run -p 8080:8080 \
  -e TURSO_URL=http://host.docker.internal:8081 \
  -e WORKER_SECRET=your-secret \
  blip

环境变量

变量 必填 默认 描述
PORT 没有 8080 服务器端口
TURSO_URL 是的 http://localhost:8081 libsql/turso数据库URL
TURSO_AUTH_TOKEN 无 -- Turso身份验证令牌(生产)
WORKER_SECRET 是的 dev-secret 用于验证入站电子邮件传递的共享密钥
FRONTEND_URL 没有 http://localhost:4321 CORS的前端URL

发展

看 贡献.md 用于开发设置和贡献指南。

# Run tests
./gradlew :server:core:test

# Build CLI
./gradlew :cli:installDist
./cli/build/install/cli/bin/cli --help

# Build MCP server
cd mcp-server && npm install && npm run build

许可证

此存储库使用按组件许可:

组件 许可证
server/core AGPL-3.0
mcp-server 麻省理工学院
cli 麻省理工学院
shared-models 麻省理工学院

API服务器为AGPL-3.0,以确保对托管服务的修改保持开源。 MCP服务器、CLI和共享模型都是MIT,以实现最大的采用灵活性。