哔哔声
即时一次性电子邮件收件箱。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 "命令行界面
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许可证
此存储库使用按组件许可：
API服务器为AGPL-3.0，以确保对托管服务的修改保持开源。 MCP服务器、CLI和共享模型都是MIT，以实现最大的采用灵活性。